菜单
基础设施技能——维护项目 docs/ 目录的模块化组织和进度追踪。由编排器在 Plan 末尾和 Deliver 阶段强制调用，禁止跳过。模块文档按业务维度分目录存放详细内容，进度记录按日期/会话hash存放摘要。支持多人协作和跨会话任务追溯，文件头部标识 Git 账号。 务必在以下场景使用本 skill：创建文档、文档目录管理、docs 目录、产出物管理、输出文档、document output、docs management、模块文档、文档分类、多人协作文档、跨会话文档、进度记录、任务摘要、progress、会话记录、开发日志。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Infrastructure skill — maintains modular organization and progress tracking for the project docs/ directory. Mandatory invocation by orchestrator at end of Plan and during Deliver stages; must not be skipped. Module documents are organized by business dimension in subdirectories with detailed content; progress records are stored as summaries by date/session hash. Supports multi-person collaboration and cross-session task tracing with Git account identification in file headers. Use this skill when: creating documents, document directory management, docs directory, deliverable management, output documentation, document output, docs management, module documentation, document classification, multi-person collaborative documentation, cross-session documentation, progress records, task summaries, progress, session records, development logs.
Full-lifecycle flow orchestrator for project development. Upon receiving user input, it first classifies the input (4 tiers), then adaptively senses project context, scores task difficulty, selects the optimal route, and orchestrates the Plan→Execute→Validate→Deliver four-phase pipeline with quality gates and failure reflow. Use this skill when: the user wants to start a new project, receives a new requirement, needs a full development iteration, wants to go through the complete flow from requirements to delivery, or says things like "start building", "launch the project", "how to implement this requirement", "help me plan this", "do it end-to-end". When the user's intent is to complete an end-to-end development task (rather than just one step), use this skill to orchestrate the entire flow. If the user only needs a specific step (e.g., just write requirement docs), use the corresponding specialized skill directly.
Infrastructure skill — maintains project file tree snapshots and code structure summaries in a SQLite database (.cache/context.db) at the project root, solving the problem of models forgetting project structure across sessions. Mandatory invocation by orchestrator during context awareness stage (before route selection) and Deliver stage; must not be skipped. Scans all project files (source, config, docs, tests, assets), never modifies files. Use this skill when: understanding overall project structure, querying a module's file list and exported symbols, restoring project structure understanding across sessions, project awareness, context sync, project memory, code summary indexing, viewing project structure. This skill does not modify source code or manage document outputs.
项目开发全生命周期的流程编排器。接收用户输入后，先做输入分类（4 档），自适应感知项目上下文、评估任务难度、选择最优路径，编排 Plan→Execute→Validate→Deliver 四阶段并管理质量卡点和失败回流。 务必在以下场景使用本 skill：用户要开始一个新项目、接到一个新需求、要做一次完整的开发迭代、要从需求到交付走一遍完整流程，或者用户说"开始做"、"启动项目"、"这个需求怎么落地"、"帮我规划一下"、"从头到尾做一遍"。 当用户的意图是完成一个端到端的开发任务（而不是只做其中某一步），使用本 skill 来编排整个流程。如果用户只需要其中某一步（如只写需求文档），直接使用对应的专项 skill。
基础设施技能——在项目根目录 .cache/context.db（SQLite）中维护项目文件树快照与代码结构摘要，解决模型跨会话遗忘项目结构的问题。由编排器在上下文感知阶段和 Deliver 阶段强制调用，禁止跳过。扫描项目中所有文件（源码、配置、文档、测试、资源），不修改任何文件。 务必在以下场景使用本 skill：需要了解项目全局结构、查询某模块的文件列表和导出符号、跨会话恢复项目结构理解、项目感知、context sync、项目记忆、project memory、代码摘要索引、查看项目结构。本 skill 不修改源码，不管理文档产出。
API 接口契约与类型系统的详细设计工具。从领域模型和需求文档出发，生成 RESTful/GraphQL API 端点定义、Request/Response DTO 结构、错误响应标准、OpenAPI 规范以及类型代码骨架。产出输出到 specs/{module}/api-contract.md（按业务模块分目录）。 务必在以下场景使用本 skill：用户需要设计 API 接口、定义数据传输对象(DTO)、编写接口文档、制定错误码规范，或者用户说"设计接口"、"定义 API"、"写接口契约"、"DTO 设计"、"接口规范"、"错误码"、"OpenAPI"、"Swagger"。 当用户的任务涉及从业务模型到技术接口的转化时使用本 skill。
| name | docs-output |
| description | 基础设施技能——维护项目 docs/ 目录的模块化组织和进度追踪。由编排器在 Plan 末尾和 Deliver 阶段强制调用，禁止跳过。模块文档按业务维度分目录存放详细内容，进度记录按日期/会话hash存放摘要。支持多人协作和跨会话任务追溯，文件头部标识 Git 账号。 务必在以下场景使用本 skill：创建文档、文档目录管理、docs 目录、产出物管理、输出文档、document output、docs management、模块文档、文档分类、多人协作文档、跨会话文档、进度记录、任务摘要、progress、会话记录、开发日志。 |
本 Skill 解决两个核心问题：
本 Skill 管理 docs/ 目录的两类内容：模块详细文档 + 进度摘要记录。
graph TD
TASK["模型执行任务<br/>需求分析 · Bug修复 · 技术方案"]
MODULES["docs/{module}/<br/>模块文档<br/>详细功能描述"]
PROGRESS["docs/progress/{date}/{hash}.md<br/>进度摘要<br/>会话级记录"]
TASK -->|"详细产出"| MODULES
TASK -->|"摘要记录"| PROGRESS
style TASK fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
style MODULES fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
style PROGRESS fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
docs/auth/login.md）。禁止扁平输出（如 docs/login.md）。docs/ 根目录下（如 docs/login.md）。必须放在业务模块子目录下（如 docs/auth/login.md）。docs/progress/{date}/{username}_{hash}.md。docs_manager.py 脚本产生，禁止 LLM 自行计算或拼接时间字符串（常见错误：UTC时间手动+8小时产生 25:xx 等非法时间）。docs/
├── auth/ # 业务模块 — 详细文档
│ ├── login.md
│ └── register.md
├── user/
│ ├── profile.md
│ └── settings.md
├── progress/ # 进度记录
│ ├── 2024-01-15/
│ │ ├── zhangsan_a3f8c1.md # 用户名_会话hash
│ │ └── lisi_b7d2e4.md
│ ├── 2024-01-16/
│ │ └── zhangsan_c9e5f0.md
│ └── archive/ # 归档（>30天）
│ └── 2024-01/
│ └── ...
auth、user、dashboard）login.md、register.md）docs/progress/{YYYY-MM-DD}/{username}_{会话hash}.mdgit config user.name（空格替换为 -，全小写）a3f8c1），保证唯一python scripts/docs_manager.py progress 命令执行，禁止 LLM 直接生成/写入进度 Markdown 文件。脚本保证时间戳使用系统本地时间（datetime.now()），避免时区计算错误。完整命名规则见 →
references/naming-rules.md
每个文件包含一个或多个记录条目。同会话中每完成一个任务，追加一个 --- 分隔的条目。仅包含有内容的段落，空段落不输出：
# 会话进度：{username}_{hash}
> huyongle <568055454@qq.com> · 2026-04-09 10:38:13 起
---
## [10:38:13] 用户认证模块需求分析 · 需求开发
完成登录/注册流程的领域模型设计
- `docs/auth/login.md` — 新增登录流程文档
> **决策**: 采用 JWT + Refresh Token 双令牌方案
---
## [10:52:40] 修复 Token 刷新竞态 · Bug修复
并发 refresh 导致旧 token 覆盖新 token，用互斥锁解决
> **遗留**: 补充 refresh token 过期降级方案
---
## [11:05:22] 代码审查 · 其他
Review PR #42，无变更
规则：类型合并到标题（
[时间] 主题 · 类型）；变更文件直接列在摘要后；决策/遗留用>引用块；无内容的段落不输出。
在指定模块目录下创建新文档。
创建或覆盖指定模块文档，内容由参数提供。Deliver 阶段强制使用此命令。
--content 参数传入完整 Markdown 正文（包含功能描述、接口定义、技术决策等）创建或追加会话进度记录。
{username}_{hash}.md，写入头部（Git 信息）+ 首条记录--session-id：追加条目到已有文件，每条记录带 [HH:mm:ss] 秒级时间session_id，后续调用复用按模块和进度分别列出 docs/ 下所有内容。
检查文档目录的基本健康状态。
将超过 30 天的进度记录移入 progress/archive/YYYY-MM/。
git user.name 和 git user.email，可追溯到具体开发者python scripts/docs_manager.py create --root <project_root> --module <模块名> --name <文档名> [--title <一级标题>]
python scripts/docs_manager.py update --root <project_root> --module <模块名> --name <文档名> --content <内容> [--title <标题>]
python scripts/docs_manager.py progress --root <project_root> --topic <主题> --type <类型> --summary <摘要> [--session-id <会话ID>] [--files <变更文件JSON>] [--decisions <决策>] [--todos <遗留>]
python scripts/docs_manager.py list --root <project_root>
python scripts/docs_manager.py validate --root <project_root>
python scripts/docs_manager.py archive --root <project_root> [--older-than <天数>]
输出均为 JSON 格式，便于模型解析。