mcpField
A
archon-dev

archon-dev

github.com/coleam00开发23.8k247 次安装今天更新
代码仓库

关于 archon-dev

archon-dev 是一项开发工作流技能，可将请求分配给研究、规划、实现、审查、调试及 GitHub 任务的操作手册。它把项目产物存放在专用目录，并遵循项目约定和证据要求。

主要功能

  1. 01按意图路由至对应操作手册
  2. 02研究、规划与实现工作流
  3. 03代码审查与调试指引
  4. 04GitHub 问题与拉取请求任务
  5. 05项目产物分类管理

适用场景

  1. 01调查代码库的工作方式
  2. 02将需求转化为实现计划
  3. 03审查拉取请求或排查故障

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/coleam00/archon --skill archon-dev

安装后在 Claude Code 中输入/archon-dev确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

cookbooks/
commit.md
debug.md
implement.md
investigate.md
issue.md
plan.md
pr.md
prd.md
research.md
review.md

详细介绍

archon-dev

开发工作流 — 研究、规划、构建、审查、交付。

当前状态

  • 分支：!git branch --show-current 2>/dev/null || echo "not in git repo"
  • 产物：!ls .claude/archon/ 2>/dev/null || echo "none yet"
  • 活跃计划：!ls .claude/archon/plans/*.plan.md 2>/dev/null | head -5 || echo "none"

路由

读取 $ARGUMENTS 并确定要加载哪个操作手册。

如果用户明确指定了某个操作手册（例如，“plan”“implement”），就使用该手册。 否则，根据关键词匹配意图：

意图关键词操作手册
代码库问题，记录现有内容"research", "how does", "what is", "where is", "trace", "find"cookbooks/research.md
策略研究、库评估、可行性"investigate", "should we", "can we", "compare", "evaluate", "feasibility", "best way to", "best approach"cookbooks/investigate.md
编写产品需求"prd", "requirements", "spec", "product requirement"cookbooks/prd.md
创建实施计划"plan", "design", "architect", "write a plan"cookbooks/plan.md
执行现有计划"implement", "execute", "build", "code this", .plan.md 路径cookbooks/implement.md
审查代码或 PR"review", "review PR", "code review", "review changes"cookbooks/review.md
调试或根因分析"debug", "rca", "root cause", "why is", "broken", "failing"cookbooks/debug.md
提交更改"commit", "save changes", "stage"cookbooks/commit.md
创建拉取请求"pr", "pull request", "create pr", "open pr"cookbooks/pr.md
向 GitHub 报告问题"issue", "report to gh", "log in github", "file a bug", "feature request", "create issue", "gh issue"cookbooks/issue.md

如果意图不明确：询问用户要使用哪个操作手册。

完成路由后：读取匹配的操作手册文件，并严格遵循其中的说明。

工作流链

操作手册之间相互衔接。完成一个后，建议接下来使用哪个：

research ──► investigate ──► prd ──► plan ──► implement ──► commit ──► pr
                              ▲                    │
             debug ───────────┘      review ◄──────┘
                 │
                 ▼
               issue ──► plan (if feature) or debug (if bug)

产物目录

所有产物都放在 .claude/archon/ 中。首次使用时按需创建子目录。

.claude/archon/
├── prds/              # Product requirement documents
├── plans/             # Implementation plans
│   └── completed/     # Archived after implementation
├── reports/           # Implementation reports
├── issues/            # GitHub issue investigations
│   └── completed/
├── reviews/           # PR review reports
├── debug/             # Root cause analysis
└── research/          # Research findings

项目检测

不要硬编码特定项目的命令。动态检测：

  • 包管理器：检查是否存在 bun.lockb → bun、pnpm-lock.yaml → pnpm、yarn.lock → yarn，否则使用 npm
  • 验证命令：检查 package.json 脚本中是否有 validate、check 或 verify
  • 测试命令：检查 package.json 中是否有 test 脚本
  • 约定：阅读 CLAUDE.md，了解项目特定规则

规则

  1. 以证据为依据：关于代码库的每项陈述都必须引用 file:line
  2. 禁止猜测：如有不确定，先调查
  3. 尽早失败：立即报告错误，绝不掩盖
  4. 遵循 CLAUDE.md：项目约定优先于操作手册默认设置
  5. 不注明 AI 署名：绝不要在提交或 PR 中添加“Generated with Claude”或“Co-Authored-By: Claude”

评论

支持 Markdown