Skip to content

staruhub/ClaudeSkills / skills/Geek-skills-keqian-method

keqian-method

Verified

胥克谦式AI-Native产品开发方法论。适用于:(1) 使用AI Agent(Claude Code、Codex、Cursor等)进行产品级软件开发,(2) 设计和优化Harness/Skill体系,(3) 文档驱动开发(SDD)流程,(4) 构建自动化质量门禁和eval机制,(5) Token成本优化与缓存策略,(6) 产品人转型开发者的AI编程实践。触发场景包括"帮我设计开发流程"、"怎么降低token成本"、"怎么提高AI编码质量"、"文档驱动"、"质量门禁"、"harness设计"、"单agent vs multi-agent"、"自动化迭代"、"AI产品开发"、"SDD"、"eval机制"等。即使用户只是说"帮我用AI写代码"或"怎么让agent干活更靠谱"也应触发。注意:如果产品是行为开放、用户输入不可穷举的AI-native类型,请改用 xuefeng-method skill。不用于:单个bug修复或小改动(无需方法论)、PRD需求文档写作(用product-manager)。

FileKindSize
SKILL.mdskill md8.8 KB
evals/routing-evals.jsonconfig1.8 KB
references/eval-patterns.mdmarkdown4.0 KB
references/sdd-framework.mdmarkdown2.7 KB

references/sdd-framework.md

View on GitHub
# SDD文档驱动开发框架

## 核心理念

不写文档 → 没有架构观 → AI只能盲干 → 质量不可控

文档不是给人看的附属品,而是给AI看的"操作手册"。
文档质量直接决定AI产出质量。

---

## 文档层次结构

```
Level 0: 产品愿景文档(Why)
├── 产品定位、目标用户、核心价值
└── 人工撰写,AI辅助优化

Level 1: PRD / 需求文档(What)
├── 功能列表、用户故事、验收标准
├── AI辅助撰写 + 人工深度审核
└── 每个功能点至少5个用例(不是3个敷衍)

Level 2: 技术架构文档(How)
├── 技术栈选择(模板化决策矩阵)
├── 模块划分、接口规范、数据模型
├── AI维护 + 人工把关
└── 变更时自动触发文档更新

Level 3: 实现指南(How exactly)
├── 编码规范、命名约定、目录结构
├── 直接嵌入repo(AGENTS.md / CLAUDE.md)
└── Agent直接读取执行

Level 4: 质量定义(How good)
├── Eval标准、门禁规则、threshold定义
├── 每个功能对应的验收脚本
└── 自动化执行,人工仲裁
```

---

## 文档 vs 代码的精力分配

| 阶段 | 文档 | 代码 | 说明 |
|------|------|------|------|
| 项目启动 | 90% | 10% | 几乎全部精力在文档 |
| 核心开发 | 60% | 40% | 持续维护文档 |
| 迭代收敛 | 40% | 60% | 文档趋于稳定 |
| 长期维护 | 70% | 30% | 文档是harness的核心 |

总体平均:**70%文档 / 30%代码**

---

## 技术栈选择模板

技术栈选择是套路化的事,不需要每次重新思考:

```markdown
### 决策矩阵

| 维度 | 选项A | 选项B | 选项C | 权重 |
|------|-------|-------|-------|------|
| 团队熟悉度 | | | | 30% |
| 社区生态 | | | | 20% |
| AI Agent友好度 | | | | 25% |
| 长期维护成本 | | | | 15% |
| 性能需求匹配 | | | | 10% |

注意:AI Agent友好度是新增维度,包括:
- 模型训练数据中该技术栈的覆盖度
- 代码补全/生成的准确率
- 调试信息的可读性
```

---

## 文档自动维护机制

```
代码变更 PR
    ↓
门禁检查:文档是否需要同步更新?
    ↓ 需要
自动生成文档更新PR
    ↓
人工审核文档更新
    ↓
合并
```

关键:让AI自己维护文档,代码再vibe对齐。
不要让文档和代码脱节,这是文档驱动的死穴。

---

## 文档门禁规则

1. **新增功能**:必须先有文档,再写代码
2. **技术栈变更**:必须更新决策矩阵
3. **接口变更**:必须同步更新接口文档
4. **架构变更**:必须更新架构图和决策记录
5. **质量标准变更**:必须更新eval定义

门禁不通过 → 不允许合并代码。
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall