LightDevCoder/skills 包含 34 个第一方 Agent Skill，既可串联用于软件项目的规划、编码与审查，也可按需单独使用。每个包位于 skills/<name>/，由包内的 SKILL.md 统领具体行为。
发布版本： v0.2.0 发布自
v0.2.0tag——发布线承载全部 34 个第一方 Skill（33 包架构 +humanizer），为当前最新稳定版本。确切 commit 见发布收据。
仓库按实际开发场景划分为以下模块：
- 项目工作流（Project Workflow）： 覆盖从项目初始化到最终发布的全流程。
- 澄清与调研（Clarification & Research）： 在编码前理清需求、查阅一手资料。
- 执行（Execution）： 结合 Profile 与宿主特征配置并执行边界清晰的开发任务。
- 审阅（Review）： 包含只读专家检查与项目最终验收。
- 专项工作流（Specialized Workflows）： 针对文稿、知识库、语言学习与看板任务的专属工具。
- 路由导航（Router）：
ask-light检查工作区状态并推荐下一步。
技能编写参考 Matt Pocock Skills 的渐进式结构与 Sol Advisor 的环境检查设计，作为设计参考且不引入运行时外部依赖。
从默认分支 main 安装最新集合：
npx skills add LightDevCoder/skills从 main 安装指定单个 Skill（例如更新后的 agent-config Skill）：
npx skills add LightDevCoder/skills --skill agent-config
npx skills add LightDevCoder/skills --skill project-review
npx skills add LightDevCoder/skills --skill research说明： 不带 fragment 的仓库源（
LightDevCoder/skills）将跟随默认分支main，获取最新的已准入特性与集成。
若需安装可复现的历史稳定发布快照，请锁定 #v0.2.0 tag：
npx skills add LightDevCoder/skills#v0.2.0
npx skills add LightDevCoder/skills#v0.2.0 --skill project-review说明：
#v0.2.0tag 保持为 v0.2.0 发布线的不可变可复现快照，不会被main上的后续工作修改。
npx skills add LightDevCoder/skills --agent claude-codeagent-config Skill 使用可选的 Companion MCP 服务进行宿主探测与 Profile 持久化，该运行时维护于独立仓库 LightDevCoder/agent-config：
git clone https://github.com/LightDevCoder/agent-config.git
cd agent-config && npm ci && npm run build && npm install -g .
agent-config setup --check详细安装选项（指定 Agent、独立复制模式、非交互式 CI 安装）、手动复制方式与验证记录见安装指南。
$ask-light next # 根据当前上下文推荐合适的 Skill
$project-init # 初始化项目基础结构与任务契约
$clarify # 通过针对性提问澄清模糊需求
$project-clarify # 结合已有代码与文档澄清项目决策
$implement # 执行明确的开发任务并完成验证
$project-review # 执行最终验收：PASS / FAIL / BLOCKED
完整项目开发推荐遵循以下阶段，也可根据任务现状随时直接切入：
project-init
↓
project-clarify
↓
project-spec
↓
project-tickets
↓
implement
↓
project-review
↓
release-workflow
project-init：创建任务契约与基础配置。project-clarify → project-spec → project-tickets：理清需求细节、固化 SPEC 文档并拆分为可执行任务。implement：逐个执行任务并运行自动化测试。project-review：对照冻结基线验证质量；review-loop负责多轮修复。release-workflow：执行发布验证、打 tag 并完成发布。
常用单项任务路径：
clarify # 独立需求澄清与共识确认
implement # 直接执行明确的任务
diagnosing-bugs → implement # 定位疑难问题并完成修复
release-workflow # 仅执行发布流程
$ask-light # 任务不确定时获取路由建议
完整组合说明见 docs/zh-CN/workflows/。
$ask-light next
$ask-light workflow
ask-light 是 Light 工作流顾问、导航器与路由入口。它检查真实项目与工作流状态，由模型判断最合适的下一 Skill，解释原因，并在用户批准后按 Skill 调用策略与 Host 能力完成安全转换（支持的环境下可直接开始 model-invoked 目标；缺少直接 Host 转换通道时安全降级为渲染精确调用）。
详见 ask-light 与 docs/zh-CN/workflows/。
| 分组 | Skill | 详细文档 |
|---|---|---|
| 项目流程 | project-init、project-clarify、project-spec、project-tickets、implement、project-review、release-workflow |
CATALOG.zh-CN.md |
| 澄清与调研 | socratic（引擎）、clarify、project-clarify、decision-map、research、prototype、to-questionnaire |
clarification-system |
| 任务执行 | implement、agent-config（原生支持主要编码 Harness：9 种原生适配器与通用回退）、tdd、diagnosing-bugs、resolving-merge-conflicts |
execution |
| 质量审阅 | review-loop（引擎）、generic-review、code-review、project-review（验收） |
review-system |
| 专项工具 | manuscript-ops、kb-init、learn-anything、language-learning、kanban-worker、eli5、recap |
specialized-workflows |
| 协作效率 | handoff、humanizer、wizard、wait-what、writing-for-agents |
CATALOG.zh-CN.md |
每个 Skill 的完整功能、使用时机与调用方式见 CATALOG.zh-CN.md。
| 来源分类 | 管理策略 | 仓库内处理方式 |
|---|---|---|
| 第一方原生 | 集合所有者原创 | 维护于 skills/<name>/。 |
| 经批准 Port（Matt Pocock） | 保留上游行为并附 ATTRIBUTION.md |
自包含于 skills/<name>/，无外部运行时依赖。 |
| 第三方未修改 | 外部原作者维护 | 建议直接从上游安装，本仓库不冗余存放。 |
| 第三方定制修改 | 私有仓库 LightDevCoder/skills-3rdParty 托管 |
记录完整补丁、许可证与同步状态。 |
| 历史独立迁移 | 整合并入主集合 | 在发布记录中记载迁移历史与退役状态。 |
经批准的 Matt Port（共 11 个）：research、prototype、tdd、handoff、diagnosing-bugs、wizard、teach、wait-what、to-questionnaire、writing-for-agents、resolving-merge-conflicts。各包均含 ATTRIBUTION.md，无需在运行时安装上游包。
改编来源（1 个包）：humanizer 是基于 blader/humanizer（2.11.2）实质性转换的第一方能力，外加参考 op7418/Humanizer-zh 的薄中文适配层；两份 MIT 许可均在其 ATTRIBUTION.md 中保留。