dev-skills

为个人开发者沉淀的软件开发流程类 skill 集合，配套 Codex CLI 与 Claude Code 使用。

针对碎片化、长周期、单人节奏的开发场景：想法持续变化、开发周期被频繁打断、文档与代码容易脱节。两个 skill 配合使用，从"想法"到"落地"全程维持连贯。

目录

Skill	角色	何时启用
project-docs-maintainer	项目文档维护	任务涉及调整范围、方向、模块边界、技术选型；一项工作刚落地；会话自然收尾
feature-design-flow	新功能设计流程	用户提出新功能、新页面、新交互意图（前端优先、后端倒推）

协作模型

用户提出新想法
    │
    ↓
project-docs-maintainer 识别 → 提示走 feature-design-flow
    │
    ↓
feature-design-flow 推进四阶段（文字框架 → 原型 → 接口倒推 → 实现）
    │
    └─ 每阶段末调 project-docs-maintainer 落库：
         阶段1完 → PLAN.md 待决策 / ROADMAP.md
         阶段2完 → PLAN.md 正在做 + 原型路径
         阶段3完 → 设计文档加接口契约
         阶段4完 → CHANGELOG.md + 删除原型目录

文档骨架

project-docs-maintainer 维护的最小文档集（统一放 docs/ 下，AGENTS.md 例外）：

文件	角色	关键边界
docs/OVERVIEW.md	项目是什么、当前阶段	不写实现细节、不写计划
docs/ROADMAP.md	模块拆分 / 目标形态 / 已决策事项	不排时间，只排顺序与依赖
docs/PLAN.md	滚动工作板	只面向未来，不留历史
docs/CHANGELOG.md	日期流水账	只追加
AGENTS.md（仓库根）	AI 入口指针	10 行内，指向上述文件

仓库已有 README.md、ADR 体系、CLAUDE.md 时按规则复用，不强制另建。

安装

软链到 Codex 或 Claude Code 的 skills 目录即可。两边可共享一份。

# 克隆到任意路径
git clone https://github.com/tdfydfy/dev-skills.git ~/dev-skills

# 软链到 Codex
ln -s ~/dev-skills/project-docs-maintainer ~/.codex/skills/project-docs-maintainer
ln -s ~/dev-skills/feature-design-flow ~/.codex/skills/feature-design-flow

# 软链到 Claude Code
ln -s ~/dev-skills/project-docs-maintainer ~/.claude/skills/project-docs-maintainer
ln -s ~/dev-skills/feature-design-flow ~/.claude/skills/feature-design-flow

设计取向

• 最小集起步：仓库尚无文档时按需逐步补，不一次性铺满。
• 复用优先：已有 README / ADR / Keep a Changelog / CLAUDE.md 时沿用。
• 状态驱动而非关键词驱动：何时读写文档由"状态变化"触发，不靠字面动词。
• 防过度更新：同一任务进度更新一次即可，文档不是日志。
• 前端优先，后端倒推：用户可见的功能由前端定型再设计接口；纯算法/数据例外。
• 原型不是草稿，是受约束的探索：原型代码按项目规范生成，有机会直接搬迁为生产代码。