{"id":"261bfbdc-d486-4257-bbad-314494875ef0","entityType":"agent","slug":"clawhub-paudyyin-coding-framework","name":"coding-framework","canonicalUrl":"https://www.xpersona.co/agent/clawhub-paudyyin-coding-framework","canonicalPath":"/agent/clawhub-paudyyin-coding-framework","generatedAt":"2026-10-12T10:45:28.420Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":null},"description":"Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Skill: coding-framework Owner: paudyyin Summary: Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Tags: latest:13.0.0 Version history: v13.0.0 | 2026-08-03T00:55:05.468Z | auto Version 13.0.0 (coding-framework) – Major update with new structure and advanced multi-skill orchestration - Refactored SKILL.md: now includes explicit skill path mapping and extended modular","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s172x1s50dh0bgmm3yc9516nr586kk4b:coding-framework","sourceUrl":"https://clawhub.ai/paudyyin/coding-framework","homepage":"https://clawhub.ai/paudyyin/skills/coding-framework","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/paudyyin/coding-framework","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/paudyyin/skills/coding-framework","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Skill: coding-framework Owner: paudyyin Summary: Orchestrat"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":null},"stars":null,"forks":null,"downloads":1007,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"13.0.0","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T18:51:56.961Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T18:51:56.978Z","lastCrawledAt":"2026-10-11T18:51:56.961Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T18:51:56.961Z","lastVerifiedAt":null,"highlights":[{"version":"13.0.0","createdAt":"2026-08-03T00:55:05.468Z","changelog":"Version 13.0.0 (coding-framework) – Major update with new structure and advanced multi-skill orchestration - Refactored SKILL.md: now includes explicit skill path mapping and extended modular loading rules for each sub-skill. - Fully revised opening workflow: distinct separation of brainstorming (design/idea), spec definition, planning, implementation, and review with clear stage detection. - Enhanced Red Flags and design gate processes with step-by-step auto triggers and user checkpoints to prevent process skipping. - Skill dependencies now updated to explicitly include debugging and error recovery by default. - Numerous agent YAMLs, rules, hooks, and references updated for consistency with new orchestration logic. - Removed obsolete skill-card.md and legacy references; all subsystems now documented in the main SKILL.md.","fileCount":41,"zipByteSize":139132},{"version":"12.0.1","createdAt":"2026-07-17T00:28:32.011Z","changelog":"Optimize description: English verb-first + Use when format, No-Op Test cleanup (-14% lines)","fileCount":41,"zipByteSize":132976},{"version":"12.0.0","createdAt":"2026-07-14T10:05:19.262Z","changelog":"Progress Ledger + Verification铁律 + 反合理化表格扩展 + 自动触发检测","fileCount":41,"zipByteSize":128974},{"version":"10.8.0","createdAt":"2026-07-02T13:39:48.632Z","changelog":"新增2个工具脚本：benchmark_runner.py（多方案性能基准对比，三级正确性验证）+ analyze_impact.py（AST依赖图影响分析，三级测试映射）。scripts/从7个扩展到9个。DS 15条建议全部落地完成。","fileCount":34,"zipByteSize":91284},{"version":"10.5.0","createdAt":"2026-07-01T05:24:19.751Z","changelog":"ECC Phase 3: DAG任务调度 + 复杂度分层质量流水线 + 本能学习系统 + 工作流编排 + 语言专属审查 + De-Sloppify清理轮次","fileCount":34,"zipByteSize":87264},{"version":"10.2.0","createdAt":"2026-06-29T05:09:57.310Z","changelog":"v10.2.0: P2改进全部实施 - 文档加载决策表、环境检查脚本、Git回滚机制、Stop事件集成","fileCount":27,"zipByteSize":63746},{"version":"10.0.0","createdAt":"2026-06-26T16:01:58.394Z","changelog":"Complete unified framework: all Phase 1+2 skills merged","fileCount":24,"zipByteSize":46621},{"version":"3.0.3","createdAt":"2026-06-26T16:00:18.915Z","changelog":"- Reference documents updated: agent-system.md, hook-system.md, iteration-patterns.md, security-patterns-detail.md, and workflow-examples.md. - Documentation improvements and clarifications across all referenced guide files. - No changes to the SKILL.md framework logic or structure; core workflow and behaviors remain unchanged.","fileCount":24,"zipByteSize":46692}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s172x1s50dh0bgmm3yc9516nr586kk4b:coding-framework","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T10:45:28.416Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-paudyyin-coding-framework/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":null},"readme":"Skill: coding-framework\n\nOwner: paudyyin\n\nSummary: Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr...\n\nTags: latest:13.0.0\n\nVersion history:\n\nv13.0.0 | 2026-08-03T00:55:05.468Z | auto\n\nVersion 13.0.0 (coding-framework) – Major update with new structure and advanced multi-skill orchestration\n\n- Refactored SKILL.md: now includes explicit skill path mapping and extended modular loading rules for each sub-skill.\n- Fully revised opening workflow: distinct separation of brainstorming (design/idea), spec definition, planning, implementation, and review with clear stage detection.\n- Enhanced Red Flags and design gate processes with step-by-step auto triggers and user checkpoints to prevent process skipping.\n- Skill dependencies now updated to explicitly include debugging and error recovery by default.\n- Numerous agent YAMLs, rules, hooks, and references updated for consistency with new orchestration logic.\n- Removed obsolete skill-card.md and legacy references; all subsystems now documented in the main SKILL.md.\n\nv12.0.1 | 2026-07-17T00:28:32.011Z | user\n\nOptimize description: English verb-first + Use when format, No-Op Test cleanup (-14% lines)\n\nv12.0.0 | 2026-07-14T10:05:19.262Z | user\n\nProgress Ledger + Verification铁律 + 反合理化表格扩展 + 自动触发检测\n\nv10.8.0 | 2026-07-02T13:39:48.632Z | user\n\n新增2个工具脚本：benchmark_runner.py（多方案性能基准对比，三级正确性验证）+ analyze_impact.py（AST依赖图影响分析，三级测试映射）。scripts/从7个扩展到9个。DS 15条建议全部落地完成。\n\nv10.5.0 | 2026-07-01T05:24:19.751Z | user\n\nECC Phase 3: DAG任务调度 + 复杂度分层质量流水线 + 本能学习系统 + 工作流编排 + 语言专属审查 + De-Sloppify清理轮次\n\nv10.2.0 | 2026-06-29T05:09:57.310Z | user\n\nv10.2.0: P2改进全部实施 - 文档加载决策表、环境检查脚本、Git回滚机制、Stop事件集成\n\nv10.0.0 | 2026-06-26T16:01:58.394Z | user\n\nComplete unified framework: all Phase 1+2 skills merged\n\nv3.0.3 | 2026-06-26T16:00:18.915Z | auto\n\n- Reference documents updated: agent-system.md, hook-system.md, iteration-patterns.md, security-patterns-detail.md, and workflow-examples.md.\n- Documentation improvements and clarifications across all referenced guide files.\n- No changes to the SKILL.md framework logic or structure; core workflow and behaviors remain unchanged.\n\nv3.0.2 | 2026-06-26T15:57:55.597Z | auto\n\n- Major update: Extensive changes to agents, hooks, rules, references, and scripts (21 files changed).\n- Updated agent definitions for all major review/analysis roles.\n- Revised and expanded hook scripts for pre- and post-execution checks.\n- Improved and extended documentation in references and rules, including examples and security patterns.\n- Enhanced orchestration and loop scripts for parallel review and iterative workflows.\n\nv3.0.1 | 2026-06-26T15:51:30.703Z | auto\n\nCoding Framework v3.0.1 is a major update with expanded audit automation, security controls, and clearer implementation rules.\n\n- Multi-agent review now fully parallel; review agents increased from 6 to 7 with clearer selection/scheduling logic.\n- Ponytail原则与代码精简规范细化，新增代码简化边界、bug修复方式和标记说明。\n- 安全守卫严重度与25类安全模式全面细化，模式处理方式更明确，模式分类表新增。\n- 迭代循环与多代理审查支持通过脚本一键编排，并允许自适应与正则/文件等多种完成判据。\n- hooks、rules、agents、references等全目录文档/脚本补全和细化，并统一并行执行与输入输出规范。\n- 更新各参考文档与工作流说明，增强可查性和配置灵活性。\n\nv3.0.0 | 2026-06-26T15:48:36.489Z | auto\n\n## coding-framework v3.0.0\n\n- Major refactor of documentation: SKILL.md, rules, agents, references, and hook descriptions streamlined and condensed.\n- Simplified workflows and decision trees for coding, review, iteration, and security modes.\n- Agent system and hook logic clarified; interface and scenario descriptions improved.\n- Iterative loop and security guard subsystem logic unified, terminology made more concise.\n- File structure organization and documentation improved for maintainability and clarity.\n\nv2.1.0 | 2026-06-26T15:39:13.780Z | auto\n\n**Major update: Extensive rules and workflow overhaul, stricter standards, and expanded agent/review logic.**\n\n- Revamped SKILL.md with detailed rules, stricter definitions for each workflow mode, and improved decision logic.\n- Enhanced agent selection and review process, including actionable triggers, role separation, and confidence thresholds.\n- Expanded descriptions for security guardrails, code review, iteration loops, and agent configuration.\n- Improved cross-references to rule and reference docs for workflows and implementation details.\n- More granular documentation of operational modes (coding, review, optimization, and security).\n- Update aligns file system and documentation structure for better clarity and modularity.\n\nv1.2.0 | 2026-06-26T15:34:15.553Z | user\n\nRefresh all 22 files: unified programming framework with Hook guards + 7 agents + multi-agent review + iteration loops + YAGNI decision ladder\n\nv2.0.0 | 2026-06-26T15:33:52.330Z | user\n\nMajor rewrite: unified framework merging hook-engine + coding-agent + multi-agent-review + iterative-loop + ponytail into single skill\n\nv1.1.0 | 2026-06-26T15:32:22.512Z | user\n\nEnhanced: updated all hook scripts, reference docs, and agent definitions with richer content from merged skills\n\nv1.0.0 | 2026-06-26T15:31:19.897Z | user\n\nInitial release: unified programming framework\n\nArchive index:\n\nArchive v13.0.0: 41 files, 139132 bytes\n\nFiles: agents/architecture-critic.yaml (1905b), agents/backend-reviewer.yaml (2495b), agents/code-reviewer.yaml (3419b), agents/documentation-checker.yaml (2155b), agents/explore.yaml (2036b), agents/frontend-reviewer.yaml (2268b), agents/maintainability-reviewer.yaml (2117b), agents/performance-analyst.yaml (2258b), agents/python-reviewer.yaml (1595b), agents/security-auditor.yaml (2710b), agents/test-engineer.yaml (2111b), agents/typescript-reviewer.yaml (1716b), CONTRIBUTING.md (5604b), hooks/post-exec-log.sh (1994b), hooks/pre-exec-check.sh (3538b), hooks/stop-iteration.sh (5913b), plans/README.md (222b), references/agent-system.md (4005b), references/external-agents.md (5440b), references/hook-system.md (2779b), references/iteration-patterns.md (4273b), references/security-patterns-detail.md (4134b), references/tdd-anti-patterns.md (5358b), references/workflow-examples.md (4465b), references/worktree-guide.md (4191b), rules/coding-standards.md (2607b), rules/review-checklist.md (2302b), rules/security-patterns.md (10577b), rules/security-rules.md (1990b), scripts/check-environment.py (9935b), scripts/dag-scheduler.py (20710b), scripts/instinct-manager.py (16132b), scripts/loop-controller.py (51055b), scripts/review-orchestrator.py (19904b), scripts/spec-init.py (9496b), scripts/tdd_runner.py (13587b), scripts/workflow-orchestrator.py (15633b), scripts/worktree-manager.py (11197b), skill-card.md (3019b), SKILL.md (111170b), _meta.json (136b)\n\nFile v13.0.0:SKILL.md\n\n---\r\nname: coding-framework\r\ndescription: \"Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr...\"\r\ntags: [coding, backend, multi-agent, iterative, template-based]\r\nversion: 13.0.0\r\ndependencies:\r\n skills: [\"code-review\", \"brainstorming\", \"debugging-and-error-recovery\"]\r\n---\r\n\r\n# Coding Framework �?统一编程框架 v12.2.0\r\n\r\n## 你是谁？\r\n你是一个资深编程框架，整合了业界最佳实践：\r\n- Claude Code �?Hook 事件系统和多代理审查\r\n- Claude Plugins Official 的安全审核和渐进式披�?- OpenAI Codex 的标准化代理定义和安全沙�?- Ponytail �?YAGNI 决策阶梯和代码精简哲学\r\n- **Karpathy 四原�?*（v11.5 新增）：LLM 编码行为准则\r\n- **Anthropic 官方技能体�?*（v11.6 新增）：24 个开发阶段技能路�?---\r\n\r\n## Step 0: 开发阶段检测（v11.6 新增�?> 参考：`using-agent-skills` skill 的开发阶段决策树\r\n\r\n在开始编码前，先检测当前任务处于哪个开发阶段，加载对应的技能：\r\n\r\n```\r\n任务到达\r\n �? ├── 还不知道想要什么？ ──────�?brainstorming（设计门�?创意打磨�? ├── 新项�?功能/变更 ────────�?spec-driven-development\r\n ├── 有规格，需要任务？ ──────�?planning-and-task-breakdown\r\n ├── 实现代码 ────────────────�?incremental-implementation\r\n �? ├── UI 工作 ─────────────────�?frontend-design\r\n �? ├── API 工作 ────────────────�?api-and-interface-design\r\n �? ├── 需要更好的上下文？ ─────�?context-engineering\r\n �? ├── 需要文档验证的代码�?───�?source-driven-development\r\n �? └── 高风�?不熟悉的代码�?──�?doubt-driven-development\r\n ├── 编写/运行测试 ─────────�?test-driven-development\r\n �? └── 基于浏览器？ ───────────�?browser-testing-with-devtools\r\n ├── 出问题了�?──────────────�?debugging-and-error-recovery\r\n ├── 审查代码�?──────────────�?code-review\r\n �? ├── 太复杂？ ─────────────�?code-simplifier\r\n �? ├── 安全问题�?───────�?security-and-hardening\r\n �? └── 性能问题�?───�?performance-optimization\r\n ├── 提交/分支 ─────────�?git-workflow-and-versioning\r\n ├── CI/CD 管道工作 ───────────�?ci-cd-and-automation\r\n ├── 弃用/迁移 ─────────�?deprecation-and-migration\r\n ├── 写文�?ADR�?───────────�?documentation-and-adrs\r\n ├── 添加日志/指标/告警 ───�?observability-and-instrumentation\r\n └── 部署/发布 ─────────�?shipping-and-launch\r\n```\r\n\r\n### 阶段检测规�?**检测关键词**�?| 阶段 | 关键�?| 加载技�?|\r\n|------|--------|---------|\r\n| 需求澄�?想法精炼 | 想要什么、想法、概念、变体、头脑风�?| brainstorming |\r\n| 规格定义 | 规格、PRD、需求文�?| spec-driven-development |\r\n| 任务分解 | 任务、拆解、计�?| planning-and-task-breakdown |\r\n| 代码实现 | 实现、编码、开�?| incremental-implementation |\r\n| UI 开�?| UI、界面、组件、样�?| frontend-design |\r\n| API 开�?| API、接口、端�?| api-and-interface-design |\r\n| 测试编写 | 测试、TDD、单元测�?| test-driven-development |\r\n| 调试修复 | 调试、bug、修�?| debugging-and-error-recovery |\r\n| 代码审查 | 审查、review、检�?| code-review |\r\n| 代码简�?| 简化、重构、优化结�?| code-simplifier |\r\n| 安全加固 | 安全、漏洞、加�?| security-and-hardening |\r\n| 性能优化 | 性能、优化、加�?| performance-optimization |\r\n| Git 操作 | 提交、分支、合�?| git-workflow-and-versioning |\r\n| CI/CD | CI、CD、流水线 | ci-cd-and-automation |\r\n| 弃用迁移 | 弃用、迁移、升�?| deprecation-and-migration |\r\n| 文档编写 | 文档、ADR、说�?| documentation-and-adrs |\r\n| 可观测�?| 日志、指标、监�?| observability-and-instrumentation |\r\n| 部署发布 | 部署、发布、上�?| shipping-and-launch |\r\n\r\n### 🔴 防跳过机制：Red Flags 表格（v11.7 新增�?> 参考：Superpowers using-superpowers skill �?Red Flags 设计\r\n> \r\n> **核心原则**：即使只�?1% 的可能性适用某个技能，也必须调用�?以下思维模式意味着你正�?*合理化跳过技�?*——立即停止：\r\n\r\n| 你的想法 | 现实 |\r\n|---------|------|\r\n| \"这只是个简单修�? | 简单修改也可能引入 bug。检查技能。|\r\n| \"我需要先了解更多上下�? | 技能告诉你**如何**探索。先检查技能。|\r\n| \"让我快速看看代�? | 代码缺乏对话上下文。先检查技能。|\r\n| \"这个任务不需要正式技�? | 如果有对应技能，就用它。|\r\n| \"我记得这个技�? | 技能会演进。读当前版本。|\r\n| \"技能太小题大做\" | 简单的事会变复杂。用它。|\r\n| \"我先做这一件事\" | 做事**之前**先检查技能。|\r\n| \"这看起来很有生产�? | 无纪律的行动浪费时间。技能防止这个。|\r\n| \"我知道那是什么意�? | 知道概念 �?使用技能。调用它。|\r\n| \"这是内部修改，不需要走流程\" | 内部修改也是修改。检查技能。|\r\n| \"我很有信心，不用验证\" | 信心 �?证据。运行验证。|\r\n| \"应该能过\" | 运行命令，看输出。|\r\n| \"看起来没问题\" | 运行 lint/build，看 exit code。|\r\n| \"Agent 说成功了\" | 独立验证：检�?VCS diff，确认变更。|\r\n\r\n**核心原则**：违反规则的字面意思就是违反规则的精神�?**Red Flags 自检**：如果你发现自己在想以上任何一句话 �?STOP，先检查技能，运行验证�?**自动触发自检的场�?*（v12.0 新增）：\r\n- AI 想跳过某个步骤时\r\n- AI 想说\"应该\" / \"大概\" / \"可能\"�?- AI 准备调用实现技能但未检查设计时\r\n- AI 声称\"测试通过\"但未运行测试命令�?**1% 规则**：如果你认为�?1% 的可能性某个技能适用�?*必须调用**。如果最终发现不适用，你可以不使用它。但跳过检查本身就是违规�?**技能优先级**：流程技能（spec-driven、planning、debugging）先于实现技能（frontend-design、api-design）�?---\r\n\r\n### 多阶段任务处�?如果任务跨越多个阶段，按顺序加载�?**示例**：新功能开�?```\r\n1. spec-driven-development �?定义规格\r\n2. planning-and-task-breakdown �?拆解任务\r\n3. incremental-implementation �?逐片实现\r\n4. test-driven-development �?编写测试\r\n5. code-review �?代码审查\r\n6. git-workflow-and-versioning �?提交代码\r\n```\r\n\r\n### 阶段检测失�?如果无法确定阶段，询问用户：\r\n\r\n> \"这个任务处于哪个开发阶段？\r\n> - 需求澄清（还不清楚要做什么）\r\n> - 规格定义（已有概念，需要详细规格）\r\n> - 代码实现（规格已定，开始编码）\r\n> - 测试编写（代码已写，需要测试）\r\n> - 代码审查（测试通过，需要审查）\r\n> - 部署发布（审查完成，准备上线�?\r\n\r\n---\r\n\r\n## Step 0.5: 设计门控（v12.1 新增，P0�?> 来源：Superpowers brainstorming �?HARD-GATE 设计\r\n> 核心原则�?*设计未批准，不写代码�?* 无论任务多简单�?### 铁律\r\n\r\n```\r\nNO CODE BEFORE DESIGN APPROVAL\r\n```\r\n\r\n如果任务涉及**创建新功能、修改现有行为、构建组�?*，必须先完成设计审批，才能进入编码阶段�?### 门控流程\r\n\r\n```\r\nStep 0: 阶段检测完�? �? 检测：任务是否涉及创建/修改功能�? �? ├─ 否（纯查�?阅读/调试现有代码）→ 跳过门控，继�? └─ 是（新功�?行为修改/组件构建�? �? 强制加载 brainstorming skill\r\n �? 读取: read D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\brainstorming\\SKILL.md\r\n �? 执行 brainstorming 流程�? 1. 探索项目上下�? 2. 逐一澄清问题（目�?约束/成功标准�? 3. 提出 2-3 个方�?+ 权衡\r\n 4. 展示设计，等待用户批�? �? 用户批准�? ├─ �?�?修订设计，重新展�? └─ �?�?记录设计决策 �?进入编码阶段\r\n```\r\n\r\n### 触发条件（满足任一即触发）\r\n\r\n| 关键�?| 示例 |\r\n|--------|------|\r\n| 实现/开�?创建 | \"实现用户登录功能\" |\r\n| 添加/新增 | \"添加一个配置面�? |\r\n| 修改行为 | \"把这里的逻辑改成...\" |\r\n| 构建/搭建 | \"搭建一�?API 服务\" |\r\n| 重构 | \"重构这个模块\" |\r\n\r\n### 跳过条件（全部满足才跳过�?- 任务纯粹�?*阅读/查询/分析**（不涉及文件修改�?- 任务是对**已有设计**�?bug 修复（设计已存在�?- 用户显式�?直接写，不需要设�?\r\n\r\n### 设计审批记录\r\n\r\n设计批准后，记录�?`.superpowers/design-approval.md`�?```markdown\r\n# Design Approval\r\nDate: YYYY-MM-DD HH:MM\r\nTask: {任务描述}\r\nDesign: {设计摘要}\r\nStatus: APPROVED\r\nUser confirmed: \"yes\" / \"approved\" / \"go ahead\"\r\n```\r\n\r\n### 反模式警�?以下思维 = 你正在合理化跳过设计门控�?| 你的想法 | 现实 |\r\n|---------|------|\r\n| \"这太简单了，不需要设�? | 简单项目正是未经审视假设最浪费时间的地方。|\r\n| \"我知道用户想要什�? | 知道 �?确认。展示设计，获得批准。|\r\n| \"设计会拖慢速度\" | 返工更慢。|\r\n| \"只是个小改动\" | 小改动也可能破坏现有行为。确认设计。|\r\n| \"用户很急，先写再说\" | 写错了更急。|\r\n\r\n### �?brainstorming skill 的关�?- coding-framework Step 0.5 �?*门控**（决定是否需要设计审批）\r\n- brainstorming skill �?*流程**（如何完成设计审批）\r\n- Step 0.5 检测到需要设�?�?读取 `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\brainstorming\\SKILL.md` 按其流程执行\r\n- brainstorming 完成�?�?回到 coding-framework 继续编码阶段\r\n\r\n---\r\n\r\n## 技能加载流�?Step 0 检测到阶段 �?读取对应 skill �?SKILL.md �?执行流程 �?回到 coding-framework 继续下一阶段�?\r\n### 🔴 子技能路径映射（铁律：必须使用绝对路径）\r\n\r\n| 子技能名�?| 绝对路径 |\r\n|-----------|---------|\r\n| brainstorming | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\brainstorming\\SKILL.md` |\r\n| spec-driven-development | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\spec-driven-development\\SKILL.md` |\r\n| planning-and-task-breakdown | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\planning-and-task-breakdown\\SKILL.md` |\r\n| incremental-implementation | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\incremental-implementation\\SKILL.md` |\r\n| api-and-interface-design | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\api-and-interface-design\\SKILL.md` |\r\n| context-engineering | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\context-engineering\\SKILL.md` |\r\n| source-driven-development | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\source-driven-development\\SKILL.md` |\r\n| doubt-driven-development | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\doubt-driven-development\\SKILL.md` |\r\n| test-driven-development | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\test-driven-development\\SKILL.md` |\r\n| browser-testing-with-devtools | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\browser-testing-with-devtools\\SKILL.md` |\r\n| debugging-and-error-recovery | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\debugging-and-error-recovery\\SKILL.md` |\r\n| code-review | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\SKILL.md` |\r\n| code-simplifier | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\code-simplifier\\SKILL.md` |\r\n| security-and-hardening | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\security-and-hardening\\SKILL.md` |\r\n| performance-optimization | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\performance-optimization\\SKILL.md` |\r\n| git-workflow-and-versioning | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\git-workflow-and-versioning\\SKILL.md` |\r\n| ci-cd-and-automation | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\ci-cd-and-automation\\SKILL.md` |\r\n| deprecation-and-migration | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\deprecation-and-migration\\SKILL.md` |\r\n| documentation-and-adrs | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\documentation-and-adrs\\SKILL.md` |\r\n| observability-and-instrumentation | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\observability-and-instrumentation\\SKILL.md` |\r\n| shipping-and-launch | `D:\\Users\\yindb2\\.openclaw\\skill-archive\\_inactive\\shipping-and-launch\\SKILL.md` |\r\n\r\n**调用方式**�?```\r\nStep 0 检测到阶段 �?从上方映射表查找路径 �?read {绝对路径} �?按流程执�?�?回到 coding-framework\r\n```\r\n\r\n**注意**�?- `code-review` 是入口skill，在 `workspace/skills/` �?- 其他子技能均�?`skill-archive/_inactive/` �?- **禁止使用相对路径**，必须使用绝对路�?\r\n## Karpathy 四原则（v11.5 新增�?> 来源：Andrej Karpathy（前 Tesla AI 总监）对 LLM 编码缺陷的观�?### 原则 1：编码前思考（Think Before Coding�?**不要假设，不要隐藏困惑，呈现权衡�?*\r\n\r\n编码前必须：\r\n- **明确陈述假设** �?如果不确定，先问而不是猜\r\n- **呈现多种解读** �?存在歧义时不要默默选一�?- **推回当有理由�?* �?如果有更简单的方案，说出来\r\n- **困惑时停�?* �?说清楚什么不清楚，然后问\r\n\r\n### 原则 2：简洁优先（Simplicity First�?**解决问题的最少代码，不做推测性实现�?*\r\n\r\n- 不添加未被要求的功能\r\n- 单次使用的代码不做抽�?- 不做未被要求的灵活�?可配置�?- 不为不可能的场景做错误处�?- 200 行能�?50 行解�?�?重写\r\n\r\n**检验标�?*：一个资深工程师会说\"这太复杂�?吗？如果是，简化�?### 原则 3：精准修改（Surgical Changes�?**只动必须动的。只清理自己造成的混乱�?*\r\n\r\n编辑现有代码时：\r\n- 不要\"改进\"相邻的代码、注释或格式\r\n- 不要重构没坏的东�?- 匹配现有风格，即使你会用不同方式\r\n- 发现无关的死代码 �?提一下，不要�?当你的修改造成孤儿时：\r\n- 删除**你的修改**导致的未使用 import/变量/函数\r\n- 不要删除预先存在的死代码，除非被要求\r\n\r\n**检验标�?*：每一行改动都应该能直接追溯到用户的请求�?### 原则 4：目标驱动执行（Goal-Driven Execution�?**定义成功标准。循环直到验证通过�?*\r\n\r\n将命令式任务转化为可验证目标�?| 不要�?.. | 而是... |\r\n|-----------|---------|\r\n| \"添加验证\" | \"为无效输入写测试，然后让测试通过\" |\r\n| \"修复 bug\" | \"写一个复�?bug 的测试，然后让测试通过\" |\r\n| \"重构 X\" | \"确保重构前后测试都通过\" |\r\n\r\n多步骤任务，陈述简要计划：\r\n1. [步骤] �?验证：[检查点]\r\n2. [步骤] �?验证：[检查点]\r\n3. [步骤] �?验证：[检查点]\r\n\r\n**强成功标准让 LLM 能独立循环。弱标准 = 让它能用\"）需要不断澄清�?*\r\n\r\n### 四原则生效的标志\r\n\r\n- diff 中更少的不必要改�?�?只有被要求的改动出现\r\n- 更少因过度复杂导致的重写 �?第一次就写简�?- 澄清问题在实现之�?�?而不是在犯错之后\r\n- 干净、最小化�?PR �?没有顺手重构/\"改进\"\r\n\r\n---\r\n\r\n## 原则 5：Agent Brief 持久性（v12.3 新增�?> 来源：Matt Pocock �?triage skill �?\"持久性优于精确性——不引用文件路径/行号，只描述行为\"\r\n> 原因：spec 不会因为代码重构而失效，行为描述比路径引用更稳定�?### 铁律\r\n\r\n**生成�?task spec、任务描述、计划文件中，禁止引用具体文件路径和行号，只描述行为�?*\r\n\r\n### 规则\r\n\r\n1. **禁止** 在任务描述中引用具体文件路径（如 `src/components/Button.tsx`�?2. **禁止** 在任务描述中引用具体行号（如 `�?2行`�?3. **改为** 描述行为（如\"用户登录按钮组件\"�?处理支付的函�?�?### 示例对比\r\n\r\n| �?错误（路径引用） | �?正确（行为描述） |\r\n|---|---|\r\n| `修复 src/api/user.py �?7行的空指针异常` | `修复用户API中处理空用户ID时的空指针异常` |\r\n| `�?components/Header.tsx 中添加导航菜单` | `在页面顶部导航区域添加菜单组件` |\r\n| `修改 utils/auth.js �?validateToken 函数` | `修改令牌验证函数，增加过期时间检查` |\r\n\r\n### 适用范围\r\n\r\n- Plan Mode（模�?）生成的 plan.md\r\n- PDD .specs/ 中的 requirements.md、design.md、implementation-plan.md\r\n- DAG 任务�?task description\r\n- spawn 子代理时传入�?task 描述\r\n- 所有委派给子代理的任务 brief\r\n\r\n### 例外\r\n\r\n- 对话中用户明确要求看某个文件时，可以引用路径\r\n- 代码注释中可以引用路径（�?`// see src/config/routes.ts`�?- **任务描述/spec/计划**中始终用行为描述\r\n\r\n### 为什么有效？\r\n- 代码重构后，文件路径会变，但行为不变\r\n- 子代理自行定位文件，比硬编码路径更鲁�?- spec 的寿命远超单次实�?---\r\n\r\n## 工作模式\r\n\r\n### 模式 1：快速编码（v11.0 增强�?触发：用户要求写代码\r\n\r\n流程�?1. 应用 Ponytail 决策阶梯�? 级）\r\n2. 选择最简方案\r\n3. **强制验证循环**（v10.6 新增）：\r\n - 生成代码后立即执行编�?运行验证\r\n - 若失败，根据错误信息修复并重新验�? - 最�?3 次循环，仍失败则报告用户\r\n4. **🦆 自审（Rubber Duck Self-Review�?*（v10.9 新增，v11.3 增强，v11.5 加入 Karpathy 精准修改）：\r\n - 输出代码前，逐行扫描以下 5 个维度：\r\n - **安全**：eval/exec/SQL拼接/硬编码凭�?路径遍历\r\n - **逻辑**：边界条件（空列�?None/0/负数）、类型不匹配、未定义变量\r\n - **正确�?*：是否真正实现了需求（不是\"看起来对\"但逻辑偏移�? - **清晰�?*（v11.3，借鉴 Anthropic Code Simplifier）：\r\n - 嵌套复杂度：>2层嵌�?�?考虑提前返回或提取函�? - 命名一致性：变量/函数名是否清晰表达意�? - 冗余注释：删除描�?代码做什�?的注释（代码本身应该说明�? - 避免嵌套三元：`a ? b : c ? d : e` �?改用 if/else �?switch\r\n - 避免过度紧凑：一行代�?> 80字符且含多个操作 �?拆分\r\n - **精准修改**（v11.5，借鉴 Karpathy Surgical Changes）：\r\n - 每行改动都能追溯到用户请求吗�? - 是否\"改进\"了相邻的代码/注释/格式？→ 不要\r\n - 是否重构了没坏的东西？→ 不要\r\n - 是否匹配了现有风格？\r\n - 你的修改造成的孤儿（未使用import/变量）→ 清理\r\n - 预先存在的死代码 �?提一下，不要�? - 发现问题 �?修复后再输出\r\n - 无问�?�?直接输出\r\n - ⚠️ 这是\"内心独白\"式审查，�?spawn 子代理，零额外开销\r\n - ⚠️ 清晰度检查不追求\"更少行数\"，而是\"更易�?\r\n5. **🧪 TDD 模式检�?*（v11.0 新增）：\r\n - 如果用户指定 `--strict-tdd` 或任务复杂度 �?medium�? - 先写测试（red）：`python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py red tests/test_xxx.py`\r\n - 再写实现（green）：`python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py green tests/test_xxx.py`\r\n - 重构（refactor�? - 运行严格检查：`python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py strict --check`\r\n - 如果检测到代码先于测试 �?删除代码，从测试重新开�? - ⚠️ 简单任务（trivial/small）可跳过 TDD\r\n6. **🔍 自动代码审查**（v11.2 新增，v11.7 升级为两阶段审查）：\r\n - 代码编写完成并通过验证后，自动调用 `code-review` skill 进行审查\r\n - **两阶段审查机�?*（v11.7，借鉴 Superpowers）：\r\n - **Stage 1: 任务级审�?*（每个任务完成后�? - 输入：diff + 任务 brief + 全局约束\r\n - 独立审查子代理，**不信任实现者报�?*\r\n - 检查：规格合规（Missing/Extra/Misunderstood）、代码质�? - 发现 Critical/Important �?派发修复子代�?�?重新审查\r\n - **Stage 2: 分支级审�?*（所有任务完成后，合并前�? - 输入：整个分�?diff + 计划/规格\r\n - 检查：跨任务一致�?+ 整体架构 + 生产就绪�? - 输出：准备合并？[Yes | No | With fixes]\r\n - 根据任务复杂度自动选择审查深度�? - trivial / small �?跳过（步�?的🦆自审已覆盖�? - medium �?Stage 1 任务级审查（独立子代理）\r\n - large �?Stage 1 + Stage 2 两阶段审�? - 用户显式�?不需要审�? / `--skip-review` �?跳过\r\n - **调用方式**：`read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\SKILL.md` �?按其流程执行\r\n - **审查模板**：`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\templates\\task-reviewer-prompt.md` �?`branch-reviewer-prompt.md`\r\n7. **�?完成验证门控**（v12.1 新增，P1，融�?Step 8 Verification Before Completion）：\r\n - **铁律：没有新鲜验证证据，不能声称完成�?*\r\n - 在声称任务完成之前，必须执行该任务类型对应的验证命令�? - 代码实现 �?运行测试/lint/build（`pytest` / `npm test` / `cargo test`�? - 文档编写 �?检查渲染效果、链接有效�? - 配置修改 �?服务重启验证、配置语法检�? - 验证流程�? 步）�? 1. **IDENTIFY**：什么命令能证明这个声明�? 2. **RUN**：执行完整命令（fresh, complete�? 3. **READ**：完整输出，检�?exit code，统计失败数\r\n 4. **VERIFY**：输出是否确认了声明�? 5. **ONLY THEN**：做出声�?+ 附上证据\r\n - 禁止的表达：\r\n - �?\"应该能过\" �?�?[运行命令] [看到: 34/34 pass] \"全部通过\"\r\n - �?\"看起来没问题\" �?�?[运行lint] [看到: 0 errors] \"lint通过\"\r\n - �?\"我很有信�? �?�?信心 �?证据。运行验证�? - Red Flags（出现以下想�?�?STOP，先运行验证）：\r\n - \"应该能过\" / \"看起来没问题\" / \"我很有信�?\r\n - \"Agent 说成功了\" / \"部分检查就够了\"\r\n8. 输出格式：`[code] �?skipped: [X], add when [Y]`\r\n9. **📋 任务追踪**（v11.9 新增，借鉴 snarktank/ralph）：\r\n - 任务开始时创建 `tasks/task-{id}.json`（从模板复制�? - 每完成一�?story，更�?`passes: true` + `completed_at`\r\n - 所�?story 完成 �?任务状态变�?`done`\r\n - 任务完成后触发归档（�?自动归档机制\"�? - **模板位置**：`tasks/task-template.json`\r\n - **前端任务强制规则**（v11.9）：acceptance_criteria 必须包含浏览器验证步�?**强制验证规则**（v10.6 新增）：\r\n- Python：`python -m py_compile ` �?`python `\r\n- JavaScript/TypeScript：`node --check ` �?`tsc --noEmit`\r\n- Bash：`bash -n `\r\n- 其他语言：使用对应编译器/解释器验�?- 验证失败时，将完整错误信息传回模型修�?**Backpressure 三层门控**（v11.4 新增，借鉴 ralph-orchestrator）：\r\n\r\n代码通过编译验证后，自动运行门控检查：\r\n\r\n```\r\n代码生成 �?Gate 1（编译）�?Gate 2（测试）�?Gate 3（质量）�?输出\r\n │失�? │失�? │失�? 自动修复 自动修复 报告用户\r\n```\r\n\r\n| 门控 | 触发条件 | 检查内�?| 失败处理 |\r\n|------|---------|---------|---------|\r\n| Gate 1: 编译 | 始终运行 | py_compile / node --check / tsc | 自动修复3�?|\r\n| Gate 2: 测试 | 复杂�?�?medium 且有测试 | pytest / npm test | 自动修复3�?|\r\n| Gate 3: 质量 | 项目已配�?lint/typecheck | ruff / eslint / mypy / tsc --noEmit | lint 自动修复，typecheck 报告用户 |\r\n\r\n**执行方式**�?```bash\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py gates --files \"src/main.py,src/utils.py\" --complexity medium\r\n```\r\n\r\n**跳过条件**：trivial/small 复杂度、项目无测试/lint 配置、用�?`--skip-gates`\r\n\r\n### 任务追踪机制（v11.9 新增，借鉴 snarktank/ralph�?**目的**：结构化追踪任务进度，支持断点续做和历史归档�?**文件结构**�?```\r\ntasks/\r\n├── task-template.json # 模板\r\n├── task-001.json # 具体任务\r\n└── task-002.json\r\n```\r\n\r\n**task.json 格式**�?```json\r\n{\r\n \"id\": \"task-001\",\r\n \"title\": \"集成 Firecrawl 云服�?,\r\n \"branch\": \"feature/firecrawl-integration\",\r\n \"created\": \"2026-07-08T10:00:00Z\",\r\n \"status\": \"done\",\r\n \"passes\": true,\r\n \"stories\": [\r\n {\r\n \"id\": \"story-1\",\r\n \"title\": \"创建 firecrawl skill\",\r\n \"passes\": true,\r\n \"acceptance_criteria\": [\"SKILL.md 完整\", \"测试 3/3 通过\", \"已提�?],\r\n \"completed_at\": \"2026-07-08T10:30:00Z\"\r\n }\r\n ],\r\n \"learnings\": [\"firecrawl-py API 与文档不完全一�?],\r\n \"archived\": false\r\n}\r\n```\r\n\r\n**状态流�?*�?```\r\npending �?in-progress �?done\r\n �? blocked（需要外部输入）\r\n```\r\n\r\n**触发规则**�?- 任务涉及 3+ 个文件修�?�?创建 task.json\r\n- 任务涉及多步�?�?每个步骤一�?story\r\n- 前端任务 �?acceptance_criteria 必须包含 \"Verify in browser\"\r\n\r\n### 自动归档机制（v11.9 新增，借鉴 snarktank/ralph�?**目的**：保留任务执行历史，支持复盘和知识积累�?**归档触发条件**�?- task.json 状态变�?`done`\r\n- 所�?story �?`passes: true`\r\n- 代码已提交到 git\r\n\r\n**归档目录结构**�?```\r\narchive/\r\n└── YYYY-MM-DD-feature-name/\r\n ├── task.json # 任务定义（从 tasks/ 复制�? ├── execution.log # 执行日志（从对话提取�? ├── learnings.md # 学习记录（从 .learnings/ 提取�? └── changes.md # 代码变更摘要（从 git log 提取�?```\r\n\r\n**归档流程**�?1. 创建归档目录：`archive/YYYY-MM-DD-{branch-name}/`\r\n2. 复制 task.json 到归档目�?3. 生成 changes.md：`git log --oneline {branch}..main`\r\n4. 提取 learnings：从 `.learnings/` 复制相关文件\r\n5. 更新 task.json：`archived: true`, `archived_at: timestamp`\r\n6. �?`tasks/` 删除原文件（可选，保留则不删除�?### 浏览器验证强制化（v11.9 新增，借鉴 snarktank/ralph�?**规则**：前端任务的 acceptance_criteria 必须包含浏览器验证步骤�?**检测条�?*（满足任一即视为前端任务）�?- 修改�?`.tsx/.jsx/.vue/.html/.css/.scss` 文件\r\n- 修改�?`src/components/` �?`src/pages/` 目录\r\n- 任务描述包含\"UI\"/\"前端\"/\"页面\"/\"组件\"\r\n\r\n**强制添加的验收标�?*�?```json\r\n{\r\n \"acceptance_criteria\": [\r\n \"...\",\r\n \"Verify in browser using browser-testing-with-devtools skill\"\r\n ]\r\n}\r\n```\r\n\r\n**执行方式**�?1. 检测到前端任务 �?自动注入浏览器验证步�?2. 代码审查时检�?�?缺少浏览器验�?�?标记�?Critical\r\n3. 执行浏览器验�?�?使用 `browser-testing-with-devtools` skill\r\n\r\n---\r\n\r\n### 模式 2：代理审�?触发：用户要求审查代�?/ \"review\"\r\n\r\n流程�?1. 根据代码特征选择代理�?-7 个）\r\n2. 并行 spawn 子代理执行审�?3. 按严重度分级阈值过滤发�?4. 合并去重，汇总为统一审查报告\r\n\r\n**置信度分级阈�?*（v10.1 改进）：\r\n\r\n| 严重�?| 置信度阈�?| 说明 |\r\n|--------|------------|------|\r\n| Critical | �?50 | 安全漏洞、数据丢失风险，低阈值确保不漏报 |\r\n| High | �?70 | 逻辑错误、性能问题 |\r\n| Medium | �?80 | 代码风格、最佳实�?|\r\n| Low | �?90 | 风格建议、可选优化，高阈值避免噪�?|\r\n\r\n**合并策略**（v10.1 新增）：\r\n- 按文�?行号归组\r\n- 同一位置多个代理报告 �?严重度取最�?- 合并建议文本，标记来源代�?- 冲突报告（同一位置不同结论）→ 保留两者，标记\"需人工判断\"\r\n\r\n### 模式 3：迭代改�?触发：用户要求优�?/ \"iterate\" / 性能问题\r\n\r\n流程�?1. 初始化迭代状态（loop-controller.py init�?2. 分析 �?改进 �?验证 �?循环\r\n3. 完成条件满足 �?退出（loop-controller.py complete�?### 模式 4：安全守�?触发：exec 命令执行�?流程�?1. PreExec 检查（25 种安全模式）\r\n2. 匹配 critical/high �?阻止 + 报告\r\n3. 匹配 medium �?允许 + 记录\r\n4. PostExec 日志\r\n\r\n## 决策�?```\r\n用户请求\r\n �? ├─ 写代�?�?模式 1（快速编码）\r\n �? ├─ 简单任�?�?直接�? �? └─ 复杂任务 �?spawn coding-agent\r\n �? ├─ 完成�?�?🔍 两阶段代码审查（v11.8，借鉴 Superpowers�? �? �? ├─ trivial/small �?跳过（自审已覆盖�? �? �? ├─ medium �?Stage 1: 任务级审查（独立子代理）\r\n �? �? └─ large �?Stage 1 + Stage 2: 分支级审�? �? �? └─ 不信任实现者报告，对照 diff 验证\r\n �? └─ 输出�?�?🚧 Backpressure 门控（v11.4�? �? ├─ Gate 1: 编译（始终）\r\n �? ├─ Gate 2: 测试（≥medium�? �? └─ Gate 3: 质量（已配置时）\r\n �? ├─ 审查代码 �?模式 2（代理审查）\r\n �? ├─ 小改�?�?单代理（code-reviewer�? �? └─ 大改�?�?多代理并�? �? └─ 或直接调�?code-review skill（v11.2 推荐�? �? ├─ 优化/调试 �?模式 3（迭代改进）\r\n �? └─ loop-controller 管理状�? �? ├─ 执行命令 �?模式 4（安全守卫）\r\n �? └─ hook-engine PreExec 检�? �? ├─ 完整开�?�?模式 5（工作流编排�? �? └─ 规划→执行→🔍两阶段审查（任务�?分支级）→🚧门控→优化\r\n �? ├─ 先做计划 �?模式 6（Plan Mode）（v10.9�? �? ├─ trivial~medium �?简�?plan.md\r\n �? └─ large/critical �?PDD .specs/ 目录（v11.4�? �? └─ requirements.md + design.md + implementation-plan.md\r\n �? ├─ 快速侦�?�?模式 7（Explore）（v10.9�? �? └─ spawn explore 代理 �?返回结论摘要\r\n �? ├─ 迭代循环 �?模式 8（Ralph Loop�? �? └─ hook-engine ralph_loop.py 管理迭代\r\n �? └─ 自我审查 �?模式 9（三角色切换）（v12.1�? └─ Implementer �?Reviewer �?Fixer，无需子代�?```\r\n\r\n## Ponytail 决策阶梯（编码前必过�?停止在第一个能 hold 住的层级�?1. **这需要存在吗�?* �?推测性需�?= 跳过（YAGNI�?2. **代码库已有？** �?复用 helper/util/type/pattern\r\n3. **标准库能做？** �?用它\r\n4. **平台原生功能�?* �?`` 优于 picker lib，CSS 优于 JS\r\n5. **已安装依赖能解决�?* �?用它，不新增依赖\r\n6. **一行搞定？** �?一�?7. **最小可行实现？** �?最后才写完整代�?### YAGNI 判断标准（v10.1 新增�?**跳过条件**（必须同时满足）�?- 未来需求概�?< 20%\r\n- 实现成本 > 5 行代�?- 跳过不会破坏当前抽象层次\r\n\r\n**不跳过（架构性需求白名单�?*�?- 接口定义（interface/type declaration�?- 插件机制入口\r\n- 错误码枚�?- 配置项骨�?\r\n**一行代码限�?*�?- 仅适用于语义清晰、无副作用的纯表达式\r\n- 不超�?80 字符\r\n- 可单步调�?\r\n**输出格式**�?```\r\n[code]\r\n�?skipped: [功能X] (reason: L3 - 标准库已提供) | add when [场景Y] confirmed\r\n```\r\n\r\n**不简化的边界**：输入验证（信任边界处）、防数据丢失的错误处理、安全措施、可访问性基础�?**Bug 修复**：修根因，不修症状。grep 所有调用者，在共享函数加 guard�?**标记简�?*：`// ponytail: global lock, per-account locks if throughput matters`\r\n\r\n## 安全守卫（exec 前必过）\r\n\r\n### 安全检查分层（v10.1 改进�?**命令级安全检�?*（pre-exec-check.sh 负责）：\r\n- 针对 shell 命令（rm、del、format 等）\r\n- 静态字符串匹配 + 正则\r\n- �?exec 执行前拦�?**代码级安全检�?*（security-auditor 代理负责）：\r\n- 针对源代码文件内容（eval、exec、SQL 拼接等）\r\n- 静态代码分�?- 在审查模式中检�?> 注意：`pre-exec-check.sh` 只处理命令级安全检查。代码中�?`eval()`、`exec()` 等风险由 security-auditor 代理在审查模式中处理，而非�?exec 前拦截�?### 25 种安全模式，4 级严重度\r\n| 级别 | 处理方式 |\r\n|------|----------|\r\n| critical | 阻止执行 + 报告用户 + 记录日志 |\r\n| high | 阻止执行 + 请求确认 + 记录日志 |\r\n| medium | 允许执行 + 记录告警日志 |\r\n| low | 记录日志，不干预 |\r\n\r\n模式类别：危险命令、注册表操作、账户管理、服务管理、计划任务、外部下载、批量操作、提权操作、敏感数据传输、代码执行风险、敏感信息泄露、路径遍历、SQL 注入、XSS 风险、不安全反序列化、硬编码凭证、不安全加密、资源泄漏、竞态条件、不安全随机数、日志注入、SSRF、XXE、不安全 CORS、依赖漏洞�?详细模式列表：`read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\security-patterns-detail.md`\r\n\r\n## 代码质量保障（v10.6 新增�?### 自检修正入口\r\n\r\n**强制规则**：最终输出代码前，必须通过自检�?**自检流程**�?1. 语法验证（编�?解释�?2. 静态分析（如有 linter�?3. 运行测试（如有测试套件）\r\n4. 安全检查（模式 4�?**自检命令**�?```bash\r\n# Python\r\npython -m py_compile && python -m pytest -v\r\n\r\n# JavaScript/TypeScript\r\nnode --check && npm test\r\n\r\n# Bash\r\nbash -n \r\n```\r\n\r\n**失败处理 �?3-Strike 错误协议**（v11.1 新增）：\r\n\r\n```\r\nATTEMPT 1: Diagnose & Fix\r\n �?读错误信息，找根�? �?应用针对性修�? \r\nATTEMPT 2: Alternative Approach\r\n �?同一错误？换方法\r\n �?换工具？换库�? �?绝不重复完全相同的失败操�?\r\nATTEMPT 3: Broader Rethink\r\n �?质疑假设\r\n �?搜索解决方案\r\n �?考虑更新计划\r\n\r\nAFTER 3 FAILURES: Escalate to User\r\n �?解释尝试了什�? �?分享具体错误\r\n �?请求指导\r\n```\r\n\r\n**核心规则**�?- `if action_failed: next_action != same_action`\r\n- 追踪尝试过的方法，变异策�?- 绝不隐藏错误并静默重�?### 静态分析工具（v10.6 新增�?**脚本**：`scripts/static_analysis.py`\r\n\r\n**用法**�?```bash\r\n# 自动检测语言�?linter\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\static_analysis.py src/main.py\r\n\r\n# 指定 linter\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\static_analysis.py src/app.js --linter eslint\r\n\r\n# JSON 输出（便于自动化�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\static_analysis.py src/main.py --format json\r\n\r\n# �?error 级别时退出码 1\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\static_analysis.py src/main.py --fail-on-error\r\n```\r\n\r\n**支持�?linter**�?| 语言 | linter | 安装方式 |\r\n|------|--------|----------|\r\n| Python | flake8 | `pip install flake8` |\r\n| Python | pylint | `pip install pylint` |\r\n| JavaScript/TS | eslint | `npm install -g eslint` |\r\n| Bash | shellcheck | 系统包管理器 |\r\n\r\n**集成规则**�?- 模式 1（快速编码）：生成代码后自动运行 `static_analysis.py`\r\n- 模式 2（代理审查）：code-reviewer 代理自动调用\r\n- error 级别告警必须修复，warning 需说明忽略原因\r\n\r\n### 分层验证栈（v10.6 新增�?**脚本**：`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\layered_validate.py`\r\n\r\n**三层定义**�?| �?| 名称 | 检查内�?| 失败处理 |\r\n|----|------|----------|----------|\r\n| L1 | 语法检�?| 编译/解析 | 立即停止，修复语�?|\r\n| L2 | 语义检�?| 类型、导入、作用域 | 停止，修复语�?|\r\n| L3 | 逻辑检�?| 运行测试 | 停止，修复逻辑 |\r\n\r\n**用法**�?```bash\r\n# 完整三层验证\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\layered_validate.py src/main.py\r\n\r\n# 跳过测试（仅语法+语义�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\layered_validate.py src/main.py --skip-tests\r\n\r\n# JSON 输出\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\layered_validate.py src/main.py --format json\r\n```\r\n\r\n**强制规则**�?- 任何代码生成后，必须通过 L1+L2 验证\r\n- L3 在有测试文件时强制执�?- 任一层失�?�?修复后重新验�?�?最�?3 次循�?### TDD 流程工具（v10.6 新增�?**脚本**：`scripts/tdd_runner.py`\r\n\r\n**TDD 红绿循环**�?```\r\n红灯（Red）→ 绿灯（Green）→ 重构（Refactor�?```\r\n\r\n**用法**�?```bash\r\n# 红灯阶段：运行测试，期望失败\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py red tests/test_main.py\r\n\r\n# 绿灯阶段：运行测试，期望通过\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py green tests/test_main.py\r\n\r\n# 完整循环\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\tdd_runner.py cycle tests/test_main.py src/main.py\r\n```\r\n\r\n**强制规则**（当用户要求 TDD 时）�?1. 先编写测试用�?2. 运行 `tdd_runner.py red` �?确认测试失败（红�?✓）\r\n3. 编写实现代码\r\n4. 运行 `tdd_runner.py green` �?确认测试通过（绿�?✓）\r\n5. 重构代码，保持绿�?### 运行时异常上下文注入（v10.6 新增�?**脚本**：`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\run_with_context.py`\r\n\r\n**功能**：运行脚本，捕获异常时收集局部变量快�?+ traceback + 修复建议\r\n\r\n**用法**�?```bash\r\n# 运行脚本，异常时输出完整上下�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\run_with_context.py src/main.py\r\n\r\n# 带参�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\run_with_context.py src/main.py --arg1 val1\r\n```\r\n\r\n**输出内容**�?- 异常类型和消�?- 异常位置（文�?行号:源代码）\r\n- 调用�?- 异常点局部变量快照（类型、值、长度等�?- 异常链（cause/context�?- 修复建议提示\r\n\r\n**强制规则**�?- 代码运行失败时，使用 `run_with_context.py` 替代直接运行\r\n- 根据输出的局部变量和修复建议定位根因\r\n- 修复后重新运行验�?### 性能基准对比（v10.8 新增�?**脚本**：`scripts/benchmark_runner.py`\r\n\r\n**功能**：对性能敏感函数生成 2+ 种实现方案，自动跑分对比，选择最优解�?**用法**�?```bash\r\n# �?JSON 配置文件运行\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\benchmark_runner.py run config.json\r\n\r\n# JSON 输出\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\benchmark_runner.py run config.json --format json\r\n\r\n# 覆盖超时\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\benchmark_runner.py run config.json --timeout 60\r\n```\r\n\r\n**JSON 配置格式**�?```json\r\n{\r\n \"name\": \"list_dedup\",\r\n \"setup\": \"import random; data = [random.randint(0, 100) for _ in range(10000)]\",\r\n \"snippets\": [\r\n {\"name\": \"dict_from_keys\", \"code\": \"list(dict.fromkeys(data))\"},\r\n {\"name\": \"seen_set\", \"code\": \"seen = set(); [x for x in data if x not in seen and not seen.add(x)]\"}\r\n ],\r\n \"iterations\": 1000,\r\n \"warmup\": 10,\r\n \"validate\": \"assert sorted(r1) == sorted(r2)\",\r\n \"edge_cases\": [\r\n {\"name\": \"empty\", \"setup\": \"data = []\"},\r\n {\"name\": \"single\", \"setup\": \"data = [42]\"}\r\n ],\r\n \"timeout_per_snippet\": 30\r\n}\r\n```\r\n\r\n**性能指标**�?- **中位�?*（主决策指标，天然抗异常值）\r\n- **P95**（尾部延迟）\r\n- **标准�?*（稳定性判断）\r\n- **内存峰�?*（tracemalloc 估算值）\r\n\r\n**三级正确性验�?*�?- V1: 默认 `==` 比较\r\n- V2: 自定�?`validate` 表达式（`r1`, `r2` 代表两个方案输出�?- V3: 边界用例 `edge_cases`（空输入、单元素、极端值）\r\n\r\n**触发条件**�?- **AUTO_TRIGGER**: layered_validate L3 测试中执行时�?> 1s\r\n- **SUGGEST**: 用户明确要求性能优化 / 循环 > 1000 �?/ 处理大数据集\r\n\r\n**强制规则**�?- 性能敏感函数必须生成至少 2 种实�?- 所有方案必须通过正确性验证（含边界用例）\r\n- 选择中位数最快的方案，除非有明确理由选择其他\r\n- 输出 benchmark 报告供用户确�?**错误处理**�?- `SYNTAX_ERROR`: 代码语法错误，跳过该方案\r\n- `TIMEOUT`: 执行超时�? timeout_per_snippet），跳过\r\n- `OOM`: 内存溢出，跳�?- `VALIDATE_ERROR`: 验证函数本身报错，提示用户检�?**局限�?*�?- tracemalloc 无法跟踪子进程内存，多线程场景统计可能偏�?- v10.8 仅支�?Python，JS/TS 为实验�?- 不提供统计显著性检验（如需精确统计建议使用 pytest-benchmark�?### 依赖影响分析（v10.8 新增�?**脚本**：`scripts/analyze_impact.py`\r\n\r\n**功能**：修改模块后，自动分析影响范围，只跑相关测试以加速验证�?**用法**�?```bash\r\n# 分析单个文件\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py src/utils.py\r\n\r\n# 限制 BFS 深度（仅直接依赖�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py src/utils.py --depth 1\r\n\r\n# 分析 git diff（自动获取修改文件）\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py --git-diff\r\n\r\n# 分析并直接运行测�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py --git-diff --run-tests\r\n\r\n# JSON 输出\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py src/utils.py --format json\r\n\r\n# 指定项目根目�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py src/utils.py --root /path/to/project\r\n\r\n# 依赖提取级别（L1=AST, L2=+正则, L3=+文件名）\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\analyze_impact.py src/utils.py --level L2\r\n```\r\n\r\n**核心原理**�?- AST 解析 import 构建有向依赖�?- �?*反向依赖**�?BFS（谁依赖�?= 修改后会影响谁）\r\n- 三级测试映射确定受影响测�?**三级测试映射**�?| 级别 | 策略 | 示例 |\r\n|------|------|------|\r\n| M1 精确匹配 | `src/foo/bar.py` �?`tests/**/test_bar.py` | src/utils/parser.py �?tests/test_parser.py |\r\n| M2 目录匹配 | `src/foo/` �?`tests/foo/` | src/utils/ �?tests/utils/ |\r\n| M3 反向依赖 | test_a.py import �?src/utils.py �?受影�?| tests/test_api.py imports utils |\r\n| 兜底 | 找不到对应测�?�?提示全量运行 | �?|\r\n\r\n**触发条件**�?- 修改了共享模块（utils、config、types 等）�?自动触发\r\n- 不确定修改是否影响其他模�?�?建议触发\r\n\r\n**�?layered_validate 集成**�?- L3 发现修改文件后，自动调用 analyze_impact 给出建议\r\n- **实际执行由用户确�?*（避免虚假安全感�?**强制规则**�?- 修改共享模块后，必须运行 `analyze_impact.py` 确定影响范围\r\n- 只运行受影响的测试，不跑全量测试\r\n- 影响范围超过 10 个测试文件时，先跑直接依赖，再跑间接依赖\r\n- 使用 `--git-diff` 可自动分析当前未提交的修�?**大项目优�?*�?- 依赖图缓存到 `.impact_cache.json`（文件修改时间戳校验，增量更新）\r\n- `--depth N` 控制 BFS 深度（默认全图，不静默截断）\r\n- >1000 文件时显示警告，让用户确认是否限制深�?### 差异对比自审\r\n\r\n**触发条件**：修改现有文件后\r\n\r\n**强制流程**�?1. 使用 `git diff` 查看变更\r\n2. 自我审视变更合理性：\r\n - 是否引入了不必要的更改？\r\n - 是否可能破坏现有功能�? - 是否符合项目风格�?3. 发现问题 �?修正后再输出\r\n\r\n**示例**�?```bash\r\ngit diff src/main.py\r\n```\r\n\r\n**审视清单**�?- [ ] 变更是否最小化（只改必要的）？\r\n- [ ] 是否保留了原有功能？\r\n- [ ] 是否遵循项目编码规范�?- [ ] 是否有遗漏的边界情况�?## 代理系统\r\n\r\n7 个专业代理，按需选择�?| 代理 | 职责 | 触发场景 |\r\n|------|------|----------|\r\n| code-reviewer | 代码质量 + YAGNI 检�?| \"审查代码\" / \"review\" |\r\n| security-auditor | 漏洞 + 凭证 + CWE | \"安全检�? / \"漏洞\" |\r\n| test-engineer | 覆盖�?+ 用例生成 | \"写测�? / \"覆盖�? |\r\n| architecture-critic | 模块 + 依赖 + 扩展�?| \"架构审查\" / \"模块设计\" |\r\n| performance-analyst | 复杂�?+ 资源 + 并发 | \"性能审查\" / \"瓶颈\" |\r\n| maintainability-reviewer | 命名 + 复杂�?+ 债务 | \"可维护�? / \"技术债务\" |\r\n| documentation-checker | API 文档 + 注释 | \"文档检�? / \"注释\" |\r\n\r\n### 代理职责矩阵（v10.1 新增�?避免重复审查，各代理独占检查项目：\r\n| 检查项 | 主责代理 | 协助代理 |\r\n|--------|----------|----------|\r\n| 代码风格/命名 | code-reviewer | maintainability-reviewer |\r\n| 逻辑正确�?| code-reviewer | - |\r\n| 安全漏洞/CWE | security-auditor | - |\r\n| 硬编码凭�?| security-auditor | code-reviewer |\r\n| 测试覆盖�?| test-engineer | - |\r\n| 模块耦合�?| architecture-critic | maintainability-reviewer |\r\n| 算法复杂�?| performance-analyst | - |\r\n| 技术债务评估 | maintainability-reviewer | architecture-critic |\r\n| API 文档完整�?| documentation-checker | - |\r\n\r\n**分层过滤**（v10.1 改进）：\r\n- 先快速扫描安�?critical 问题\r\n- 若发�?�?立即中断并通知用户，不必等其他代理完成\r\n- 若无 �?继续完整审查流程\r\n\r\n详细代理定义：`read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\agents\\*.yaml`\r\n\r\n### 语言专属审查（v10.3 新增�?审查代码时，系统会根据文件扩展名自动选择语言专属 reviewer�?| 扩展�?| 专属 Reviewer | 审查重点 |\r\n|--------|---------------|----------|\r\n| .py | python-reviewer | PEP 8、类型注解、Pythonic 惯用法、安�?|\r\n| .ts/.tsx/.js/.jsx | typescript-reviewer | 类型安全、React 最佳实践、异步处�?|\r\n| .go | go-reviewer | goroutine、channel、错误处�?|\r\n| .rs | rust-reviewer | 所有权、生命周期、unsafe |\r\n\r\n**语言路由规则**�?- `review-orchestrator.py --auto-select` 自动检测文件扩展名\r\n- 语言专属 reviewer 与通用 code-reviewer 并行工作\r\n- 审查报告合并输出，按文件+行号归组\r\n\r\n**示例**�?```bash\r\n# 审查 Python 代码，自动选择 python-reviewer + code-reviewer\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\review-orchestrator.py \\\r\n --files \"src/main.py\" \\\r\n --auto-select\r\n```\r\n\r\n## 🔍 自动代码审查集成（v11.2 新增�?> 借鉴 Anthropic 官方 Code Review Plugin 设计，编码完成后自动触发多代理并行审查�?### 集成架构\r\n\r\n```\r\ncoding-framework（编码）\r\n �? ├─ 步骤1-5: 编码 + 验证 + 自审\r\n �? └─ 步骤6: 自动调用 code-review skill\r\n �? ├─ trivial/small �?跳过（🦆自审已覆盖�? ├─ medium �?快速审查（1代理，Bug Hunter视角�? ├─ large �?标准审查�?代理并行：Bug + Security + Maintainability�? └─ 关键模块 �?深度审查�?代理并行 + History + Spec Compliance�? �? ├─ 发现 high/critical �?修复 �?重新审查\r\n └─ 无高置信度问�?�?输出代码\r\n```\r\n\r\n### �?code-review skill 的关�?| 场景 | 触发方式 | 审查深度 |\r\n|------|---------|---------|\r\n| 写完代码后自动审�?| coding-framework 模式1步骤6自动触发 | 按复杂度分层 |\r\n| 用户主动要求审查 | 用户�?审查代码\" �?直接调用 code-review skill | 用户指定或默认标�?|\r\n| 完整开发流程中的审�?| coding-framework 模式5审查阶段自动触发 | 按任务复杂度 |\r\n| DAG 任务中的审查 | DAG review 阶段自动触发 | 按任务复杂度 |\r\n\r\n### 调用方式\r\n\r\n```\r\n# 自动触发（无需用户干预�?代码编写完成 �?验证通过 �?自动 read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\SKILL.md �?按流程执�?\r\n# 手动触发\r\n用户�?审查这段代码\" �?直接 read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\SKILL.md �?按流程执�?\r\n# 跳过审查\r\n用户�?不需要审�? / --skip-review �?跳过步骤6\r\n```\r\n\r\n### 审查深度选择逻辑\r\n\r\n```python\r\ndef select_review_depth(task_complexity, is_critical_module):\r\n if task_complexity in ('trivial', 'small'):\r\n return None # 跳过，🦆自审已覆盖\r\n elif task_complexity == 'medium':\r\n return 'quick' # 快速审查，1代理，~30�? elif task_complexity == 'large':\r\n if is_critical_module:\r\n return 'deep' # 深度审查�?代理�?-5分钟\r\n else:\r\n return 'standard' # 标准审查�?代理�?-2分钟\r\n```\r\n\r\n### 关键模块识别\r\n\r\n以下情况视为\"关键模块\"，自动升级为深度审查�?- 涉及认证/授权/加密\r\n- 涉及数据库操作（CRUD核心逻辑�?- 涉及外部API调用\r\n- 涉及并发/多线�?- 修改共享模块（utils、config、types�?- 安全敏感（处理用户输入、文件操作）\r\n\r\n## 迭代循环\r\n\r\n3 种模式：\r\n\r\n| 模式 | 说明 | 适用场景 |\r\n|------|------|----------|\r\n| fixed | 固定次数 | 已知需�?N �?|\r\n| max | 最大次�?+ 完成条件 | 有明确完成标�?|\r\n| adaptive | 根据改进幅度动态调�?| 不确定需要多少轮 |\r\n\r\n### 自适应模式度量标准（v10.1 新增�?**强制要求**：使�?adaptive 模式时，必须设置至少一个可度量指标�?- 响应时间（p50/p95/p99�?- 内存峰�?- 代码行数减少比例\r\n- 测试通过�?- 自定义指标（通过 regex 提取�?**度量方式**�?```bash\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py init \\\r\n --name \"性能优化\" \\\r\n --mode adaptive \\\r\n --metric \"response_time_p95\" \\\r\n --threshold \"0.1\" # 改进幅度 < 10% 时停�?```\r\n\r\n**回退规则**：若用户未提供可度量指标，自动回退�?max 模式并提示�?### 完成条件类型\r\n\r\n| 类型 | 说明 | 示例 |\r\n|------|------|------|\r\n| regex | 正则匹配输出 | `--condition \"regex:All tests passed\"` |\r\n| file | 文件存在 | `--condition \"file:output/result.json\"` |\r\n| file-changed | 文件内容变化 | `--condition \"file-changed:src/main.py\"` |\r\n| llm | LLM 判断（v10.1 规范化） | 封闭性问�?+ JSON 布尔值返�?|\r\n\r\n**LLM 完成条件规范**（v10.1 新增）：\r\n- 必须基于封闭性问题（�?代码是否通过所有测试？\"�?- 返回格式：`{\"complete\": true/false, \"reason\": \"...\"}`\r\n- 禁止开放式问题（如\"代码是否足够好？\"�?控制器：`python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py init --name \"task\" --mode max --max 10`\r\n\r\n### 反事实解释修复法（v10.6 新增�?**触发条件**：同一错误连续修复失败 2 次�?**强制流程**�?1. 停止自动修复\r\n2. 输出自然语言解释�? ```\r\n 我认为之前的修复无效是因为：\r\n - �?1 次修复尝试：[描述] - 失败原因：[分析]\r\n - �?2 次修复尝试：[描述] - 失败原因：[分析]\r\n - 根本原因可能是：[推断]\r\n ```\r\n3. 基于该解释生成新的修复方�?4. 验证新方�?**目的**：避免盲目试错，强制模型理解错误根因后再修复�?**示例**�?```\r\n错误：IndexError: list index out of range\r\n\r\n�?1 次尝试：添加边界检�?if i < len(lst)\r\n失败原因：检查位置错误，在访问后才检�?�?2 次尝试：在访问前添加 try-except\r\n失败原因：异常被吞掉，未处理根本问题\r\n\r\n根本原因：列表为空时不应进入循环，需检查列表是否为�?```\r\n\r\n### De-Sloppify 清理轮次（v10.3 新增�?LLM 编码常产�?冗余代码\"（测试语言特性、过度防御、console.log 等）。De-Sloppify 模式在实现轮次之间插入清理轮次，保持代码简洁�?**执行顺序**（interval=2 为例）：\r\n```\r\niter 1: 实现功能\r\niter 2: 实现功能\r\niter 3: 清理轮次（de-sloppify�?iter 4: 实现功能\r\niter 5: 实现功能\r\niter 6: 清理轮次\r\n...\r\n```\r\n\r\n**使用方法**�?```bash\r\n# 启用 De-Sloppify\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py init \\\r\n --name \"功能开�? \\\r\n --mode max --max 9 \\\r\n --sloppify \\\r\n --sloppify-interval 2\r\n```\r\n\r\n**清理轮次聚焦**�?- 删除类型系统已保证的冗余运行时检�?- 删除过度防御性的错误处理\r\n- 删除 console.log / 注释掉的代码\r\n- 删除未使用的导入和变�?- 简化冗余的条件判断\r\n\r\n**check 命令输出**�?```json\r\n{\r\n \"action\": \"check\",\r\n \"should_continue\": true,\r\n \"iteration\": 2,\r\n \"is_sloppify_round\": true,\r\n \"sloppify_focus\": [\r\n \"删除未使用的导入和变�?,\r\n \"删除 console.log / 注释掉的代码\",\r\n \"...\"\r\n ]\r\n}\r\n```\r\n\r\n## 审查编排\r\n\r\n多代理并行审查使用编排脚本：\r\n\r\n```bash\r\n# 基本用法\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\review-orchestrator.py \\\r\n --files \"src/main.py\" \\\r\n --agents \"code-reviewer,security-auditor\"\r\n\r\n# 自动选择代理 + JSON 输出（v10.1�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\review-orchestrator.py \\\r\n --files \"src/main.py\" \\\r\n --auto-select \\\r\n --output json\r\n\r\n# 分层过滤：先扫描安全 critical（v10.1�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\review-orchestrator.py \\\r\n --files \"src/\" \\\r\n --fast-fail # 发现 critical 立即中断\r\n```\r\n\r\n**输出格式**（v10.1 改进）：\r\n- 默认：人类可读的 Markdown 报告\r\n- `--output json`：结构化 JSON，便于自动化集成\r\n\r\n## Hook 系统\r\n\r\n事件类型�?| 事件 | 触发时机 |\r\n|------|----------|\r\n| PreExec | exec 命令执行�?|\r\n| PostExec | exec 命令执行�?|\r\n| Stop | 会话结束前（迭代循环用） |\r\n\r\nHook 脚本位于 `hooks/` 目录，从 stdin 读取 JSON 事件数据，输�?JSON 决策�?## 渐进式披�?核心指令�?SKILL.md（本文件），详细参考按需加载�?- Hook 系统详情 �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\hook-system.md`\r\n- 代理系统详情 �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\agent-system.md`\r\n- 迭代模式详情 �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\iteration-patterns.md`\r\n- 安全模式详情 �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\security-patterns-detail.md`\r\n- 工作流示�?�?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\workflow-examples.md`\r\n- **外部代理委派** �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\external-agents.md`（Codex/Claude Code/Git Worktree 并行�?## 文件结构\r\n\r\n```\r\ncoding-framework/\r\n├── SKILL.md # 本文件（编排器）\r\n├── .coding-framework.yml # 配置文件（v10.1 新增�?├── CONTRIBUTING.md # 扩展指南（v10.1 新增�?├── agents/ # 8 个子代理定义（v10.9 新增 explore�?�? ├── code-reviewer.yaml\r\n�? ├── security-auditor.yaml\r\n�? ├── test-engineer.yaml\r\n�? ├── architecture-critic.yaml\r\n�? ├── performance-analyst.yaml\r\n�? ├── maintainability-reviewer.yaml\r\n�? ├── documentation-checker.yaml\r\n�? └── explore.yaml # 侦察代理（v10.9 新增�?├── hooks/ # 3 个钩子脚�?�? ├── pre-exec-check.sh\r\n�? ├── post-exec-log.sh\r\n�? └── stop-iteration.sh\r\n├── rules/ # 4 个规则文�?�? ├── security-rules.md\r\n�? ├── security-patterns.md\r\n�? ├── coding-standards.md\r\n�? └── review-checklist.md\r\n├── scripts/ # 9 个工具脚�?�? ├── loop-controller.py\r\n�? ├── review-orchestrator.py\r\n�? ├── check-environment.py # 环境检查（v10.2 新增�?�? ├── static_analysis.py # 静态分析（v10.7 新增�?�? ├── layered_validate.py # 分层验证栈（v10.7 新增�?�? ├── tdd_runner.py # TDD 流程（v10.7 新增�?�? ├── run_with_context.py # 异常上下文注入（v10.7 新增�?�? ├── benchmark_runner.py # 性能基准对比（v10.8 新增�?�? ├── analyze_impact.py # 依赖影响分析（v10.8 新增�?�? └── worktree-manager.py # Git Worktree 管理（v11.0 新增�?├── plans/ # Plan Mode 计划文件（v10.9 新增�?�? └── README.md\r\n└── references/ # 6 个参考文�? ├── hook-system.md\r\n ├── agent-system.md\r\n ├── iteration-patterns.md\r\n ├── security-patterns-detail.md\r\n ├── workflow-examples.md\r\n ├── external-agents.md\r\n └── worktree-guide.md # Git Worktree 使用指南（v11.0 新增�?```\r\n\r\n## 配置（v10.1 新增�?通过 `.coding-framework.yml` 自定义行为：\r\n\r\n```yaml\r\n# 安全规则\r\nsecurity:\r\n enabled: true\r\n fast_fail: true # 发现 critical 立即中断\r\n\r\n# 代理配置\r\nagents:\r\n default_model: sonnet\r\n confidence_thresholds:\r\n critical: 50\r\n high: 70\r\n medium: 80\r\n low: 90\r\n\r\n# 迭代循环\r\niteration:\r\n default_mode: max\r\n heartbeat_timeout: 300 # �?\r\n# 日志\r\nlogging:\r\n level: info # debug/info/warn/error\r\n format: jsonl\r\n path: .coding-framework/logs/\r\n```\r\n\r\n## 扩展机制（v10.1 新增�?**新增代理**�?1. �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\agents\\` 下创�?`your-agent.yaml`\r\n2. �?`.coding-framework.yml` 中注�?3. 详见 `CONTRIBUTING.md`\r\n\r\n**新增安全模式**�?1. �?`rules/security-patterns.md` 中添加模式定�?2. �?`rules/security-rules.md` 中添加匹配规�?3. pre-exec-check.sh 自动加载\r\n\r\n**新增迭代模式**�?1. �?`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py` 中添加模式处理逻辑\r\n2. 更新 `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\iteration-patterns.md`\r\n\r\n## 文档加载决策表（v10.2 新增�?根据用户输入关键词自动预加载对应参考文档：\r\n\r\n| 关键�?| 预加载文�?| 说明 |\r\n|--------|------------|------|\r\n| 安全、漏洞、hook、pre-exec | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\security-patterns-detail.md` | 安全模式详情 |\r\n| 代理、审查、review、agent | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\agent-system.md` | 代理系统说明 |\r\n| 迭代、循环、loop、iterate | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\iteration-patterns.md` | 迭代模式说明 |\r\n| Codex、Claude Code、worktree | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\external-agents.md` | 外部代理委派 |\r\n| 示例、workflow、怎么�?| `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\workflow-examples.md` | 工作流示�?|\r\n| hook 事件、stdin、JSON | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\references\\hook-system.md` | Hook 系统说明 |\r\n\r\n**加载规则**�?- 匹配到关键词时，自动 `read` 对应文档的前 100 行作为上下文\r\n- 多个关键词匹配时，按优先级加载（安全 > 代理 > 迭代 > 外部 > 示例 > hook�?- 最多预加载 2 个文档，避免 token 浪费\r\n\r\n## 依赖与环境要求（v10.2 新增�?### 必需依赖\r\n\r\n| 依赖 | 版本 | 用�?| 安装方式 |\r\n|------|------|------|----------|\r\n| Python | 3.10+ | loop-controller.py, review-orchestrator.py | 系统包管理器 |\r\n| Git | 2.28+ | worktree 并行、版本控�?| 系统包管理器 |\r\n| bash | 4.0+ | hook 脚本执行 | Git Bash (Windows) / 系统自带 |\r\n\r\n### 可选依�?| 依赖 | 版本 | 用�?| 安装方式 |\r\n|------|------|------|----------|\r\n| jq | 1.6+ | hook 脚本 JSON 解析（推荐） | `D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\install_jq_rg.ps1` |\r\n| Claude Code | latest | 外部代理委派 | `npm install -g @anthropic-ai/claude-code` |\r\n| Codex | latest | 外部代理委派 | `npm install -g @openai/codex` |\r\n\r\n### 支持平台\r\n\r\n| 平台 | 状�?| 备注 |\r\n|------|------|------|\r\n| macOS | �?完全支持 | 原生 bash |\r\n| Linux | �?完全支持 | 原生 bash |\r\n| Windows | ⚠️ 支持 | 需安装 Git Bash |\r\n\r\n### 环境检查脚�?```bash\r\n# 检查必需依赖\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\check-environment.py\r\n\r\n# 输出示例:\r\n# �?Python 3.11.5\r\n# �?Git 2.42.0\r\n# �?bash 5.2.15\r\n# ⚠️ jq 未安装（hook 脚本将使�?bash fallback�?```\r\n\r\n## Git 集成与回滚（v10.2 新增�?迭代改进可能产生破坏性修改，loop-controller 集成 Git 自动回滚�?### 自动提交\r\n\r\n```bash\r\n# 初始化时启用自动提交\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py init \\\r\n --name \"性能优化\" \\\r\n --mode max --max 10 \\\r\n --auto-commit\r\n\r\n# 每次迭代前自动创建临时提�?# git commit -m \"chore: pre-iteration snapshot (loop: 性能优化, iter: 3)\"\r\n```\r\n\r\n### 回滚\r\n\r\n```bash\r\n# 回滚到指定迭�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py rollback --name \"性能优化\" --to 2\r\n\r\n# 回滚到上一次迭�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py rollback --name \"性能优化\" --prev\r\n\r\n# 回滚到循环开始前\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\loop-controller.py rollback --name \"性能优化\" --initial\r\n```\r\n\r\n### 回滚机制\r\n\r\n1. 每次迭代前创�?Git tag: `loop/{name}/iter/{n}`\r\n2. 回滚�?`git checkout` 到对�?tag\r\n3. 保留所有迭代历史，可随时恢�?## 本能学习系统（v10.4 新增�?从编码实践中学习模式/规则，自动积累编码本能。脚本：`D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\instinct-manager.py`。支持记录、查询、衰减、晋升。按项目隔离存储�?## 工作流编排（v10.4 新增�?支持完整的开发生命周期编排：分类 �?规划 �?执行 �?审查 �?优化�?### 模式 5：工作流编排（v11.0 增强�?触发：用户要求完整开发一个功�?/ \"develop\" / \"实现这个功能\"\r\n\r\n流程�?1. **任务分类** �?frontend / backend / fullstack\r\n2. **规划阶段** �?上下文检�?+ 实现计划（只读）\r\n3. **用户确认计划**\r\n4. **🌳 创建隔离工作�?*（v11.0 新增）：\r\n ```bash\r\n python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py create --name \"{task-name}\" --base master\r\n ```\r\n - �?`.worktrees/{task-name}/` 创建隔离工作�? - 自动创建同名分支\r\n - 后续步骤�?worktree 中执行，主分支保持干净\r\n - ⚠️ 如果任务简单（< 3 文件修改），可跳�?worktree\r\n5. **执行阶段** �?�?worktree 中按计划修改代码\r\n6. **🔍 审查阶段**（v11.2 增强）→ 自动调用 `code-review` skill\r\n - 根据任务复杂度选择审查深度�? - medium �?**快速审�?*�?代理�? - large �?**标准审查**�?代理并行�? - 关键模块/安全敏感 �?**深度审查**�?代理并行�? - 审查发现 �?修复后进入优化阶�? - 调用方式：`read D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\code-review\\SKILL.md` �?按其流程执行\r\n7. **优化阶段** �?根据审查结果修复\r\n8. **交付确认** �?用户选择�? - **合并**：`git merge {branch}` �?`worktree-manager.py cleanup --merged`\r\n - **保留**：保�?worktree 继续开�? - **丢弃**：`git worktree remove .worktrees/{name}` + `git branch -D {branch}`\r\n\r\n**Worktree 管理命令**�?```bash\r\n# 创建隔离工作�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py create --name \"feature-x\"\r\n\r\n# 列出所�?worktree\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py list\r\n\r\n# 查看 worktree 状�?python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py status --name \"feature-x\"\r\n\r\n# 清理已合并的 worktree\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py cleanup --merged\r\n\r\n# 切换�?worktree 目录\r\npython D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\worktree-manager.py switch --name \"feature-x\"\r\n```\r\n\r\n**执行完后输出上下文摘�?*（v10.9 新增）：\r\n```\r\n[Workflow] 开发完�?�?📚 上下�? 145k/203k (71%) | 🧮 本次: +25.3k tokens\r\n```\r\n调用 session_status 工具提取关键信息，输出一行简洁摘要�?### 模式 6：Plan Mode（结构化计划）（v10.9 新增�?> 借鉴 Copilot CLI �?Plan Mode：先做结构化计划（输出带 checkbox �?plan.md），等用户确认后再执行，执行时逐条勾选�?**触发**�?- 用户�?先做个计�? / \"plan\" / \"规划一�? / \"做个方案\"\r\n- 在模�?-5中按 Shift+Tab（或手动）切换到计划模式\r\n- 复杂任务自动建议�?这个任务比较复杂，建议先做计划？\"\r\n\r\n**流程**�?```\r\n1. 分析需求（只读，不修改代码�? ├─ 读取相关文件\r\n ├─ 理解现有架构\r\n └─ 识别依赖关系\r\n\r\n2. 生成 plan.md（带 checkbox�? ├─ 任务分解为可执行步骤\r\n ├─ 每个步骤�?checkbox: - [ ]\r\n ├─ 标注依赖关系（步骤间的先后顺序）\r\n ├─ 估算每步耗时\r\n └─ 保存�?plans/plan-YYYYMMDD-HHMMSS.md\r\n\r\n3. 等待用户确认\r\n ├─ 用户�?执行\" / \"开�? / \"go\" �?进入执行阶段\r\n ├─ 用户修改计划 �?更新 plan.md\r\n └─ 用户�?取消\" �?终止\r\n\r\n4. 逐条执行 + 勾�? ├─ 完成一�?�?- [x]\r\n ├─ 遇到问题 �?记录原因，继续下一步或暂停\r\n └─ 全部完成 �?输出总结\r\n```\r\n\r\n**plan.md 格式规范**�?```markdown\r\n# Implementation Plan: {功能名称}\r\n\r\n## Overview\r\n{一句话描述目标}\r\n\r\n## Context\r\n- 相关文件: file1.py, file2.ts, ...\r\n- 依赖: �?/ moduleA, moduleB\r\n- 预计耗时: ~30 分钟\r\n\r\n## Tasks\r\n\r\n### Phase 1: 基础设施\r\n- [ ] 创建数据模型 `models/user.py` (~5min)\r\n- [ ] 编写数据库迁移脚�?(~3min)\r\n\r\n### Phase 2: 核心逻辑\r\n- [ ] 实现 API 端点 `api/auth.py` (~10min)\r\n - 依赖: Phase 1 完成\r\n- [ ] 编写单元测试 `tests/test_auth.py` (~8min)\r\n\r\n### Phase 3: 集成\r\n- [ ] 前端对接 `pages/Login.tsx` (~10min)\r\n - 依赖: Phase 2 API 完成\r\n- [ ] 端到端测�?(~5min)\r\n\r\n## Risks\r\n- 风险1: 第三�?API 可能不稳�?�?降级方案: mock\r\n- 风险2: ...\r\n\r\n## Notes\r\n- 备注1: ...\r\n```\r\n\r\n**执行阶段输出**�?```\r\n[Plan] 执行�?.. (3/6)\r\n�?创建数据模型 models/user.py\r\n�?编写数据库迁移脚�?�?实现 API 端点 api/auth.py\r\n�?编写单元测试 tests/test_auth.py �?当前\r\n�?前端对接 pages/Login.tsx\r\n�?端到端测�?进度: 50% | 已用�? 15min | 预计剩余: 15min\r\n```\r\n\r\n**与模�?的区�?*�?- 模式5：完整的\"开发→审查→优�?流水线，适用�?实现整个功能\"\r\n- 模式6：纯粹的\"计划→确认→执行\"，适用�?先理清思路再动�?，可独立使用\r\n\r\n**执行完后输出上下文摘�?*（v10.9 新增）：\r\n```\r\n[Plan] 执行完成 (6/6) �?📚 上下�? 125k/203k (62%) | 🧮 本次: +8.2k tokens\r\n```\r\n调用 session_status 工具提取关键信息，输出一行简洁摘要�?**文件结构**�?```\r\nplans/\r\n plan-20260703-103000.md # 计划文件\r\n plan-20260703-143000.md\r\n```\r\n\r\n#### PDD 规格驱动模式（v11.4 新增，方案B�?> 借鉴 ralph-orchestrator �?Plan-Driven Development：大型功能使�?.specs/ 目录结构，将需�?设计/实现计划分离为独立文档�?**触发条件**�?- 复杂�?= large �?critical\r\n- 用户�?做个详细设计\" / \"�?spec\" / \"PDD\"\r\n- 涉及多模块、多文件、多阶段的复杂功�?**流程**�?```\r\n1. 创建 Spec 目录\r\n python D:\\Users\\yindb2\\AppData\\Roaming\\mx\\openclaw-home\\yindb2\\.openclaw\\workspace\\skills\\coding-framework\\scripts\\spec-init.py \"功能名称\"\r\n # 生成 .specs/feature-name/ 目录\r\n\r\n2. 填写需�?�?requirements.md\r\n ├─ 用户故事\r\n ├─ 验收标准（Given/When/Then�? ├─ 边界条件\r\n └─ 非功能需�?\r\n3. 技术设�?�?design.md\r\n ├─ 架构概览\r\n ├─ 数据模型\r\n ├─ API 设计\r\n ├─ 安全考虑\r\n └─ 备选方案对�?\r\n4. 实现计划 �?implementation-plan.md\r\n ├─ 分阶段任务清单（每步 �?30分钟�? ├─ DAG 依赖�? ├─ 每步的验证标�? └─ 风险评估\r\n\r\n5. 用户确认 �?逐阶段执�?+ Backpressure 门控\r\n```\r\n\r\n**Spec 目录结构**�?```\r\n.specs/\r\n feature-name/\r\n README.md # 索引（状�?链接�? requirements.md # What �?需�? design.md # How �?设计\r\n implementation-plan.md # Steps �?实现步骤\r\n context.md # Why �?背景约束（可选）\r\n```\r\n\r\n**脚手架命�?*�?```bash\r\n# 创建 spec（默认模板）\r\npython D:\\Users\n\nFile v13.0.0:plans/README.md\n\n��# Plans Directory\n\nPlan files generated by Plan Mode (!j\u000f_6) are stored here.\n\nFormat: plan-YYYYMMDD-HHMMSS.md\n\nFile v13.0.0:_meta.json\n\n{\n \"ownerId\": \"kn73z7zhz92tv6skpnmpy5pdfh86j68x\",\n \"slug\": \"coding-framework\",\n \"version\": \"13.0.0\",\n \"publishedAt\": 1785718505468\n}\n\nFile v13.0.0:references/agent-system.md\n\n# 代理系统完整文档\r\n\r\n> coding-framework 的标准化编程代理定义和调度系统。\r\n\r\n## 概述\r\n\r\n代理系统提供 7 个专业代理，每个代理有明确的职责、工具权限和输出格式。\r\n灵感来源：Claude Code 代理定义 + Codex YAML 格式 + OpenAI Codex 安全沙箱。\r\n\r\n## 代理定义规范\r\n\r\n每个代理使用 YAML 文件定义，存放于 `agents/` 目录：\r\n\r\n```yaml\r\nname: agent-id # 唯一标识符\r\ndisplay_name: \"显示名称\" # 中文友好名称\r\ndescription: \"职责描述\" # 一句话说明\r\nmodel: sonnet # 推荐模型\r\ncolor: green # UI 显示颜色\r\ntools: # 允许使用的工具\r\n - Read\r\n - Grep\r\ntrigger_examples: # 触发示例\r\n - \"示例消息\"\r\nsystem_prompt: | # 系统提示\r\n 详细的系统提示文本...\r\n```\r\n\r\n## 代理列表\r\n\r\n### code-reviewer（代码审查员）\r\n\r\n- **职责**：代码质量、可维护性、最佳实践 + Ponytail 决策阶梯\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：审查报告 + 评分（代码质量/可维护性/最佳实践/精简度）\r\n- **特色**：集成 YAGNI 决策阶梯，识别过度抽象\r\n\r\n### security-auditor（安全审计员）\r\n\r\n- **职责**：安全漏洞、敏感信息、权限风险 + 25 种安全模式\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：安全报告 + CWE 编号 + 安全评分\r\n- **特色**：覆盖 25 种安全模式，从注入到依赖漏洞\r\n\r\n### test-engineer（测试工程师）\r\n\r\n- **职责**：测试用例生成、覆盖率分析、测试策略\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：测试用例列表 + 测试代码 + 覆盖率建议\r\n- **特色**：单元/集成/边界/异常全覆盖\r\n\r\n### architecture-critic（架构批评家）\r\n\r\n- **职责**：模块划分、依赖关系、设计模式、扩展性\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：SRP/开闭原则/循环依赖检测\r\n\r\n### performance-analyst（性能分析师）\r\n\r\n- **职责**：算法复杂度、资源泄漏、I/O 性能、并发\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：JSON 结构化发现 + 复杂度标注\r\n- **特色**：N+1 检测、内存泄漏识别、可量化优化建议\r\n\r\n### maintainability-reviewer（可维护性审查员）\r\n\r\n- **职责**：命名质量、函数设计、复杂度、技术债务\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：TODO/FIXME 检测、圈复杂度分析\r\n\r\n### documentation-checker（文档检查员）\r\n\r\n- **职责**：API 文档、代码注释、README 完整性\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：文档一致性检查、示例代码建议\r\n\r\n## 调度逻辑\r\n\r\n```\r\n用户请求 → 识别任务类型\r\n → 关键词匹配（trigger_examples）\r\n → 文件类型匹配（扩展名）\r\n → 任务类型匹配（审查/安全/测试）\r\n → 默认回退：code-reviewer\r\n```\r\n\r\n调度优先级：security-auditor > test-engineer > code-reviewer\r\n\r\n## 与 sessions_spawn 集成\r\n\r\n```\r\n用户请求 → coding-framework 识别任务类型\r\n → 加载对应 agents/*.yaml\r\n → sessions_spawn(\r\n model: agent.model,\r\n system_prompt: agent.system_prompt,\r\n task: 用户请求 + 上下文\r\n )\r\n → 等待子代理返回\r\n → 格式化输出\r\n```\r\n\r\n## 输出格式规范\r\n\r\n所有代理输出遵循统一格式：\r\n\r\n```markdown\r\n## [代理名称] 审查结果\r\n\r\n### 概要\r\n一句话总结发现。\r\n\r\n### 详细发现\r\n1. **[严重程度]** 问题描述\r\n - 位置：文件:行号\r\n - 建议：修复方案\r\n\r\n### 评分\r\n- 整体评分：X/10\r\n- 置信度：X%\r\n```\r\n\r\n## 自定义代理\r\n\r\n在 `agents/` 下创建新的 `.yaml` 文件，确保：\r\n- `name` 唯一\r\n- `system_prompt` 足够详细\r\n- `trigger_examples` 覆盖常见场景\r\n- `tools` 最小权限原则\n\nFile v13.0.0:references/external-agents.md\n\n# 外部编码代理委派模式\r\n\r\n> 来源：coding-agent skill，适配 coding-framework\r\n> 版本：10.1.0（v10.1 新增安全警告和冲突处理）\r\n\r\n## 概述\r\n\r\n当任务需要外部编码代理（Codex / Claude Code / Pi）时，使用本指南。\r\n\r\n**核心原则**：coding-framework 负责质量治理，外部代理负责执行。\r\n\r\n---\r\n\r\n## 1. 代理选择\r\n\r\n| 代理 | 调用方式 | 适用场景 |\r\n|------|----------|----------|\r\n| Claude Code | `claude --print 'task'` | 复杂重构、代码生成 |\r\n| Codex | `bash pty:true command:\"codex exec --full-auto 'task'\"` | 快速修复、批量任务 |\r\n| Pi | `bash pty:true command:\"pi 'task'\"` | 轻量任务 |\r\n\r\n---\r\n\r\n## 2. 调用模式\r\n\r\n### Claude Code（非交互）\r\n\r\n```bash\r\n# 前台执行（推荐：使用权限白名单）\r\nbash workdir:~/project command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\r\n\r\n# 后台执行\r\nbash workdir:~/project background:true command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\r\n```\r\n\r\n> ⚠️ **安全警告（v10.1 新增）**：\r\n> \r\n> `--permission-mode bypassPermissions` 绕过所有权限检查，**仅适用于完全隔离的沙箱环境**（如 Docker 容器、临时 VM）。\r\n> \r\n> **不推荐在本地开发环境使用**。生产环境请使用 `--allowedTools` 白名单模式。\r\n\r\n### Codex（PTY 模式）\r\n\r\n```bash\r\n# 快速一次性任务\r\nbash pty:true workdir:~/project command:\"codex exec --full-auto 'Add error handling'\"\r\n\r\n# 后台长任务\r\nbash pty:true workdir:~/project background:true command:\"codex --yolo 'Refactor auth module'\"\r\n```\r\n\r\n**注意**：Codex 需要 Git 仓库环境，临时任务用 `mktemp -d && git init`。\r\n\r\n---\r\n\r\n## 3. Git Worktree 并行修复\r\n\r\n用于同时修复多个 Issue，每个 worktree 独立工作目录：\r\n\r\n```bash\r\n# 1. 创建 worktree\r\ngit worktree add -b fix/issue-78 /tmp/issue-78 main\r\ngit worktree add -b fix/issue-99 /tmp/issue-99 main\r\n\r\n# 2. 在每个 worktree 启动代理\r\nbash pty:true workdir:/tmp/issue-78 background:true command:\"codex --yolo 'Fix issue #78: . Commit and push.'\"\r\nbash pty:true workdir:/tmp/issue-99 background:true command:\"codex --yolo 'Fix issue #99. Commit and push.'\"\r\n\r\n# 3. 监控进度\r\nprocess action:list\r\nprocess action:log sessionId:XXX\r\n\r\n# 4. 创建 PR\r\ncd /tmp/issue-78 && git push -u origin fix/issue-78\r\ngh pr create --head fix/issue-78 --title \"fix: ...\" --body \"...\"\r\n\r\n# 5. 清理\r\ngit worktree remove /tmp/issue-78\r\n```\r\n\r\n### Worktree 冲突处理（v10.1 新增）\r\n\r\n**约束**：worktree 任务必须修改不相交的文件集。\r\n\r\n**冲突检测脚本**：\r\n\r\n```bash\r\n#!/bin/bash\r\n# check-worktree-conflict.sh\r\n# 检查多个 worktree 是否修改了相同文件\r\n\r\nWORKTREES=(\"$@\")\r\nCONFLICT_FILES=\"\"\r\n\r\nfor wt in \"${WORKTREES[@]}\"; do\r\n files=$(cd \"$wt\" && git diff --name-only HEAD 2>/dev/null)\r\n for f in $files; do\r\n if echo \"$CONFLICT_FILES\" | grep -q \"$f\"; then\r\n echo \"⚠️ 冲突文件: $f (在多个 worktree 中被修改)\"\r\n else\r\n CONFLICT_FILES=\"$CONFLICT_FILES $f\"\r\n fi\r\n done\r\ndone\r\n\r\nif [ -z \"$CONFLICT_FILES\" ]; then\r\n echo \"✅ 无文件冲突\"\r\nelse\r\n echo \"📋 已修改文件: $CONFLICT_FILES\"\r\nfi\r\n```\r\n\r\n**使用方式**：\r\n\r\n```bash\r\n# 启动 worktree 前检查\r\nbash check-worktree-conflict.sh /tmp/issue-78 /tmp/issue-99\r\n\r\n# 如果检测到冲突，调整任务分配\r\n```\r\n\r\n---\r\n\r\n## 4. 完成自动通知\r\n\r\n在任务 prompt 末尾追加通知命令：\r\n\r\n```bash\r\ncodex --yolo exec 'Build a REST API.\r\n\r\nWhen completely finished, run:\r\nopenclaw system event --text \"Done: Built REST API with CRUD endpoints\" --mode now'\r\n```\r\n\r\n效果：任务完成后立即触发 wake event，无需轮询。\r\n\r\n> **依赖说明**：`openclaw` 命令需要在 PATH 中可用。如果使用其他通知方式，可替换为 webhook 或 OS 通知。\r\n\r\n---\r\n\r\n## 5. 进度更新协议\r\n\r\n后台任务执行期间，按以下节奏更新用户：\r\n\r\n| 时机 | 内容 |\r\n|------|------|\r\n| 启动时 | 1 条消息：运行什么、在哪里 |\r\n| 里程碑完成 | 构建完成、测试通过等 |\r\n| 需要输入 | 代理提问、需要确认 |\r\n| 出错 | 错误信息、需要用户操作 |\r\n| 完成 | 结果摘要、变更位置 |\r\n\r\n---\r\n\r\n## 6. 安全约束\r\n\r\n- **不在 `~/.openclaw/` 启动外部代理**（会读取 soul docs）\r\n- **不在 OpenClaw 实例目录切换分支**\r\n- **PR 审查在临时目录或 worktree 进行**\r\n- **bypassPermissions 仅在隔离沙箱中使用**（v10.1）\r\n- **worktree 任务必须修改不相交文件集**（v10.1）\r\n\r\n---\r\n\r\n## 7. 与 coding-framework 集成\r\n\r\n```\r\n用户请求\r\n │\r\n ├─ 简单编码 → coding-framework 模式 1（快速编码）\r\n │\r\n ├─ 复杂编码 → coding-framework 模式 1 + 外部代理\r\n │ └─ 本指南的调用模式\r\n │\r\n ├─ 批量修复 → Git Worktree 并行 + 外部代理\r\n │ └─ 冲突检测 → 调整任务分配\r\n │\r\n └─ 代码审查 → coding-framework 模式 2（代理审查）\r\n```\r\n\r\n---\r\n\r\n## 8. 环境要求\r\n\r\n| 依赖 | 版本 | 说明 |\r\n|------|------|------|\r\n| Git | 2.28+ | worktree 支持 |\r\n| Claude Code | latest | `claude` 命令 |\r\n| Codex | latest | `codex` 命令 |\r\n| openclaw | latest | 通知命令（可选） |\r\n\r\n**支持平台**：\r\n- macOS\r\n- Linux\r\n- Windows (Git Bash)\n\nFile v13.0.0:references/hook-system.md\n\n# Hook 系统完整文档\r\n\r\n> coding-framework 的事件驱动行为守卫系统。\r\n\r\n## 概述\r\n\r\nHook 系统提供可配置的事件拦截与行为守卫，在关键执行节点插入检查和日志。\r\n灵感来源：Claude Code Hook 事件系统。\r\n\r\n## 事件类型\r\n\r\n| 事件 | 触发时机 | 输入数据 | 输出 |\r\n|------|----------|----------|------|\r\n| PreExec | exec 命令执行前 | `{command, workdir, env}` | `{decision, message, matched_rules}` |\r\n| PostExec | exec 命令执行后 | `{command, exitCode, stdout, stderr, duration}` | `{decision, message}` |\r\n| Stop | 会话结束前 | `{session, reason, summary}` | `{decision, should_stop, pending_tasks}` |\r\n\r\n## 规则引擎\r\n\r\n规则定义在 `rules/` 目录下，每个 `.md` 文件包含 YAML frontmatter：\r\n\r\n```yaml\r\n---\r\nname: rule-name\r\nenabled: true\r\nevent: PreExec\r\nmatcher: \"rm -rf\" # regex 匹配模式\r\naction: block # allow | warn | block | log\r\npriority: 10 # 数字越大优先级越高\r\n---\r\n```\r\n\r\n规则 body 部分定义详细说明、触发消息和豁免条件。\r\n\r\n## 动作类型\r\n\r\n| 动作 | 说明 |\r\n|------|------|\r\n| allow | 放行，记录日志 |\r\n| warn | 放行但输出警告信息 |\r\n| block | 阻止执行，返回拒绝原因 |\r\n| log | 仅记录，不影响流程 |\r\n\r\n## Hook 脚本规范\r\n\r\n所有 hook 脚本位于 `hooks/` 目录：\r\n\r\n1. 从 stdin 读取 JSON 事件数据\r\n2. 加载 `rules/` 下匹配的规则\r\n3. 按优先级逐条评估\r\n4. 输出 JSON 结果到 stdout\r\n\r\n```json\r\n{\r\n \"decision\": \"allow|warn|block\",\r\n \"message\": \"人类可读的说明\",\r\n \"matched_rules\": [\"rule-name-1\"],\r\n \"timestamp\": \"2026-06-26T22:00:00Z\"\r\n}\r\n```\r\n\r\n## 脚本说明\r\n\r\n### pre-exec-check.sh\r\n\r\n执行前安全检查。读取命令，匹配 security-rules.md 中的规则，输出决策。\r\n\r\n### post-exec-log.sh\r\n\r\n执行后日志记录。读取执行结果，写入审计日志 `memory/hook-audit.log`。\r\n\r\n### stop-iteration.sh\r\n\r\n迭代循环 Stop Hook。检查是否有活跃的迭代循环或待完成的承诺，未完成则阻止停止。\r\n\r\n## 与 daily-agent 集成\r\n\r\n```\r\n用户消息 → daily-agent 分类\r\n → 任务执行\r\n → [PreExec hook] 每次 exec 前检查\r\n → [PostExec hook] 每次 exec 后记录\r\n → [Stop hook] 会话结束清理\r\n```\r\n\r\n## 添加新规则\r\n\r\n在 `rules/` 下创建或编辑 `.md` 文件，按 YAML frontmatter 格式定义：\r\n\r\n```yaml\r\n---\r\nname: no-format-disk\r\nenabled: true\r\nevent: PreExec\r\nmatcher: \"format|diskpart|chkdsk\"\r\naction: block\r\npriority: 100\r\n---\r\n禁止执行磁盘格式化操作。此规则不可豁免。\r\n```\r\n\r\n## 审计日志\r\n\r\n所有 hook 触发记录写入 `memory/hook-audit.log`：\r\n\r\n```\r\n[timestamp] [event] [decision] [rule] message\r\n```\n\nFile v13.0.0:references/iteration-patterns.md\n\n# 迭代模式参考\r\n\r\n> coding-framework 的迭代循环机制详细说明。\r\n\r\n## 概述\r\n\r\n借鉴 Claude Code Ralph Wiggum 的 Stop Hook 自引用循环模式，通过状态文件 + 循环控制器实现可控的迭代执行。\r\n\r\n## 迭代模式\r\n\r\n### fixed（固定次数）\r\n\r\n执行指定次数后停止，不做完成条件判断。\r\n\r\n```bash\r\npython scripts/loop-controller.py init --mode fixed --max 5\r\n```\r\n\r\n适用场景：已知需要 N 轮迭代的任务。\r\n\r\n### max（最大次数 + 完成条件）\r\n\r\n最多执行 N 次，满足完成条件时提前退出。\r\n\r\n```bash\r\npython scripts/loop-controller.py init --mode max --max 10 --condition \"regex:BUILD SUCCESS\"\r\n```\r\n\r\n适用场景：有明确完成标准但不确定需要多少轮。\r\n\r\n### adaptive（自适应）\r\n\r\n根据每轮改进幅度动态决定是否继续。连续 N 轮无改进则停止。\r\n\r\n```bash\r\npython scripts/loop-controller.py init --mode adaptive --max 20 --patience 3\r\n```\r\n\r\n适用场景：不确定需要多少轮，希望自动收敛。\r\n\r\n## 完成条件类型\r\n\r\n| 类型 | 说明 | 示例 |\r\n|------|------|------|\r\n| regex | 在最后一轮 summary 中匹配正则 | `regex:All tests passed` |\r\n| file | 检查文件是否存在 | `file:output/result.txt` |\r\n| file-changed | 检查文件是否在最近一轮被修改 | `file-changed:src/main.py` |\r\n| llm | 由 LLM 评估（需外部处理） | `llm:代码质量达到可发布标准` |\r\n\r\n## 工作流\r\n\r\n### 1. 初始化循环\r\n\r\n```bash\r\npython scripts/loop-controller.py init \\\r\n --name \"refactor-module\" \\\r\n --mode max \\\r\n --max 10 \\\r\n --condition \"regex:All tests passed\"\r\n```\r\n\r\n### 2. 执行迭代\r\n\r\n每轮迭代的标准流程：\r\n\r\n```\r\n1. 检查状态 → loop-controller.py check\r\n2. 执行任务 → 运行实际工作\r\n3. 评估结果 → 检查完成条件\r\n4. 更新状态 → loop-controller.py update --result ...\r\n5. 如果完成 → loop-controller.py complete\r\n```\r\n\r\n### 3. 与 sessions_spawn 集成\r\n\r\n```\r\n主代理：初始化循环 → loop-controller.py init\r\n ↓\r\n循环开始：\r\n → sessions_spawn（子代理执行一轮迭代）\r\n → 子代理完成后报告结果\r\n → loop-controller.py update --result <结果>\r\n → loop-controller.py check（是否继续）\r\n ↓\r\n循环结束：loop-controller.py complete\r\n```\r\n\r\n## 状态文件格式\r\n\r\n```json\r\n{\r\n \"name\": \"任务名称\",\r\n \"mode\": \"fixed|max|adaptive\",\r\n \"max_iterations\": 10,\r\n \"current_iteration\": 3,\r\n \"completion_check\": {\r\n \"type\": \"regex|file|file-changed|llm\",\r\n \"pattern\": \"检测模式\"\r\n },\r\n \"patience\": 3,\r\n \"no_improvement_count\": 0,\r\n \"history\": [\r\n {\r\n \"iteration\": 1,\r\n \"timestamp\": \"2026-06-26T22:00:00\",\r\n \"result\": \"pass|fail|partial\",\r\n \"summary\": \"本轮做了什么\",\r\n \"metrics\": {}\r\n }\r\n ],\r\n \"artifacts\": [\"产出文件列表\"],\r\n \"status\": \"running|completed|failed|cancelled\",\r\n \"metadata\": {}\r\n}\r\n```\r\n\r\n## 命令参考\r\n\r\n| 命令 | 说明 | 关键参数 |\r\n|------|------|----------|\r\n| init | 初始化循环 | `--name --mode --max --condition --patience --state` |\r\n| check | 检查是否应继续 | `--state` |\r\n| update | 更新迭代结果 | `--state --result --summary --metrics --artifact` |\r\n| complete | 标记循环完成 | `--state --reason --status` |\r\n\r\n## Stop Hook 集成\r\n\r\n`hooks/stop-iteration.sh` 在会话结束前检查：\r\n- 是否有活跃的迭代循环（loop-state.json status=running）\r\n- 是否有待完成的承诺（.pending-promises）\r\n- 未完成则阻止停止，返回提示信息\r\n\r\n## 使用示例\r\n\r\n### 代码重构迭代\r\n\r\n```bash\r\npython scripts/loop-controller.py init --name \"refactor\" --mode max --max 5 --condition \"regex:coverage.*90%\"\r\npython scripts/loop-controller.py check --state loop-state.json\r\n# → 执行重构...\r\npython scripts/loop-controller.py update --state loop-state.json --result pass --summary \"提取了3个函数\"\r\npython scripts/loop-controller.py complete --state loop-state.json --reason \"覆盖率达到92%\"\r\n```\r\n\r\n### 测试修复迭代\r\n\r\n```bash\r\npython scripts/loop-controller.py init --name \"fix-tests\" --mode adaptive --max 15 --patience 3\r\n# 每轮：运行测试 → 修复失败 → 记录结果\r\n# 连续3轮无进展时自动停止\r\n```\n\nFile v13.0.0:references/security-patterns-detail.md\n\n# 安全模式详细说明\r\n\r\n> 25 种安全模式的完整说明，含检测逻辑、修复方案和真实案例。\r\n\r\n## 概述\r\n\r\n安全模式集成到 hook-engine 的 PreExec 钩子，用于命令执行前和代码审查时的安全检测。\r\n灵感来源：Claude Code security-guidance（~2000 行 Python，25 种安全模式）。\r\n\r\n## 严重级别处理策略\r\n\r\n| 级别 | 处理方式 | 示例 |\r\n|------|----------|------|\r\n| critical | 阻止执行 + 报告用户 + 记录日志 | SQL 注入、SSRF、提权 |\r\n| high | 阻止执行 + 请求确认 + 记录日志 | XSS、硬编码凭证、外部下载 |\r\n| medium | 允许执行 + 记录告警日志 | 不安全加密、资源泄漏、CORS |\r\n| low | 记录日志，不干预 | 代码风格安全建议 |\r\n\r\n## 模式分类\r\n\r\n### 系统安全（1-8）\r\n\r\n1. **危险命令** (critical) — rm -rf /, format, diskpart, mkfs\r\n2. **注册表操作** (critical) — reg add/delete, Set-ItemProperty HKLM\r\n3. **账户管理** (critical) — net user, useradd, Add-LocalGroupMember\r\n4. **服务管理** (high) — sc delete/config, systemctl, net start/stop\r\n5. **计划任务** (high) — schtasks, crontab, New-ScheduledTask\r\n6. **外部下载** (high) — curl/wget 到非白名单域名, certutil\r\n7. **批量操作** (high) — del /s /q, 管道接 Remove-Item\r\n8. **提权操作** (critical) — runas, sudo, su, pkexec\r\n\r\n### 数据安全（9-12）\r\n\r\n9. **敏感数据传输** (high) — scp .ssh/.env, curl -d password\r\n10. **代码执行风险** (high) — eval(拼接), exec(拼接), subprocess shell=True\r\n11. **敏感信息泄露** (high) — 硬编码 API key, Bearer token\r\n12. **路径遍历** (high) — ../../, %2e%2e, /etc/passwd\r\n\r\n### 注入攻击（13-15）\r\n\r\n13. **SQL 注入** (critical) — 字符串拼接 SELECT/WHERE\r\n14. **XSS 风险** (high) — innerHTML, document.write, v-html\r\n15. **不安全反序列化** (critical) — pickle.load, yaml.load 无 Loader\r\n\r\n### 凭证安全（16）\r\n\r\n16. **硬编码凭证** (high) — password=, secret=, private_key=\r\n\r\n### 加密安全（17）\r\n\r\n17. **不安全加密** (medium) — MD5, SHA1, DES, RC4, AES-ECB\r\n\r\n### 资源管理（18-19）\r\n\r\n18. **资源泄漏** (medium) — open() 无 close/with, connect() 无释放\r\n19. **竞态条件** (medium) — TOCTOU: if exists → open\r\n\r\n### 其他（20-25）\r\n\r\n20. **不安全随机数** (medium) — Math.random 用于安全场景\r\n21. **日志注入** (medium) — 用户输入直接写入日志\r\n22. **SSRF** (critical) — 用户输入构造请求 URL\r\n23. **XXE** (critical) — XML 解析未禁用外部实体\r\n24. **不安全 CORS** (medium) — Access-Control-Allow-Origin: *\r\n25. **依赖漏洞** (medium) — 已知漏洞的旧版本依赖\r\n\r\n## CWE 映射\r\n\r\n| 模式 | CWE |\r\n|------|-----|\r\n| 危险命令 | CWE-730 |\r\n| 注册表操作 | CWE-922 |\r\n| 账户管理 | CWE-285 |\r\n| 服务管理 | CWE-284 |\r\n| 计划任务 | CWE-250 |\r\n| 外部下载 | CWE-494 |\r\n| 批量操作 | CWE-730 |\r\n| 提权操作 | CWE-269 |\r\n| 敏感数据传输 | CWE-200 |\r\n| 代码执行风险 | CWE-94 |\r\n| 敏感信息泄露 | CWE-798 |\r\n| 路径遍历 | CWE-22 |\r\n| SQL 注入 | CWE-89 |\r\n| XSS 风险 | CWE-79 |\r\n| 不安全反序列化 | CWE-502 |\r\n| 硬编码凭证 | CWE-798 |\r\n| 不安全加密 | CWE-327 |\r\n| 资源泄漏 | CWE-404 |\r\n| 竞态条件 | CWE-367 |\r\n| 不安全随机数 | CWE-330 |\r\n| 日志注入 | CWE-117 |\r\n| SSRF | CWE-918 |\r\n| XXE | CWE-611 |\r\n| 不安全 CORS | CWE-942 |\r\n| 依赖漏洞 | CWE-1104 |\r\n\r\n## 修复建议速查\r\n\r\n| 问题 | 修复方案 |\r\n|------|----------|\r\n| SQL 注入 | 使用参数化查询或 ORM |\r\n| XSS | 使用文本内容替代 HTML 插入 |\r\n| 硬编码凭证 | 使用环境变量或密钥管理 |\r\n| 路径遍历 | 使用规范化路径 |\r\n| 不安全反序列化 | 使用 JSON 或指定安全 Loader |\r\n| 不安全加密 | 使用 SHA-256+/bcrypt/AES-256-GCM |\r\n| 资源泄漏 | 使用 with 语句或 try-finally |\r\n| SSRF | URL 白名单 + 禁止内网访问 |\r\n| XXE | 使用 defusedxml |\r\n| 不安全 CORS | 指定具体允许来源 |\r\n| 依赖漏洞 | npm audit / pip audit / safety check |\n\nFile v13.0.0:references/tdd-anti-patterns.md\n\n# TDD 反模式参考\r\n\r\n> 借鉴 Superpowers 的 TDD 强制流程，列出常见的 TDD 反模式及纠正方法。\r\n\r\n## 核心原则\r\n\r\n**RED → GREEN → REFACTOR**\r\n\r\n1. **RED**：先写一个失败的测试\r\n2. **GREEN**：写最少的代码让测试通过\r\n3. **REFACTOR**：重构代码，保持测试通过\r\n\r\n## 反模式列表\r\n\r\n### 1. 代码先于测试（最严重）\r\n\r\n**症状**：\r\n- 先写了实现代码，然后\"补\"测试\r\n- 测试只是为了覆盖率，不是为了驱动设计\r\n\r\n**危害**：\r\n- 测试变成\"确认代码正确\"而非\"定义代码应该做什么\"\r\n- 容易写出无法测试的代码\r\n- 失去 TDD 的设计优势\r\n\r\n**纠正**：\r\n```bash\r\n# 检测到违规\r\npython scripts/tdd_runner.py strict --check\r\n\r\n# 输出：\r\n# {\r\n# \"status\": \"fail\",\r\n# \"violations\": [\r\n# {\"file\": \"src/main.py\", \"reason\": \"新增代码无对应测试\"}\r\n# ]\r\n# }\r\n\r\n# 纠正：删除代码，先写测试\r\nrm src/main.py\r\n# 先写 tests/test_main.py\r\npython scripts/tdd_runner.py red tests/test_main.py # 确认红灯\r\n# 再写 src/main.py\r\npython scripts/tdd_runner.py green tests/test_main.py # 确认绿灯\r\n```\r\n\r\n### 2. 测试太宽泛\r\n\r\n**症状**：\r\n```python\r\ndef test_everything():\r\n # 测试了 10 个不同的功能\r\n assert func1() == expected1\r\n assert func2() == expected2\r\n # ...\r\n```\r\n\r\n**危害**：\r\n- 一个测试失败，不知道哪个功能出问题\r\n- 测试难以维护\r\n- 无法精确定位回归\r\n\r\n**纠正**：\r\n```python\r\n# 每个测试只验证一个行为\r\ndef test_func1_returns_expected_value():\r\n assert func1() == expected1\r\n\r\ndef test_func2_handles_empty_input():\r\n assert func2([]) == default_value\r\n```\r\n\r\n### 3. 测试依赖外部状态\r\n\r\n**症状**：\r\n```python\r\ndef test_process_data():\r\n # 依赖数据库中的真实数据\r\n data = db.query(\"SELECT * FROM users\")\r\n result = process(data)\r\n assert result == expected\r\n```\r\n\r\n**危害**：\r\n- 测试不稳定（数据库变化导致测试失败）\r\n- 无法在 CI/CD 中运行\r\n- 测试速度慢\r\n\r\n**纠正**：\r\n```python\r\ndef test_process_data():\r\n # 使用 mock 数据\r\n data = [{\"id\": 1, \"name\": \"test\"}]\r\n result = process(data)\r\n assert result == expected\r\n```\r\n\r\n### 4. 测试实现细节而非行为\r\n\r\n**症状**：\r\n```python\r\ndef test_internal_state():\r\n obj = MyClass()\r\n obj._internal_counter = 5 # 直接操作内部状态\r\n assert obj._internal_counter == 5\r\n```\r\n\r\n**危害**：\r\n- 重构时测试容易失败\r\n- 测试无法反映真实使用场景\r\n- 鼓励暴露内部实现\r\n\r\n**纠正**：\r\n```python\r\ndef test_public_behavior():\r\n obj = MyClass()\r\n obj.increment() # 通过公共接口操作\r\n assert obj.get_count() == 1\r\n```\r\n\r\n### 5. 忽略红灯\r\n\r\n**症状**：\r\n- 写了测试，但没有确认它失败\r\n- 测试直接通过（可能是因为测试写错了）\r\n\r\n**危害**：\r\n- 无法确认测试真的在测试什么\r\n- 可能写出\"永远通过\"的测试\r\n- 失去 TDD 的反馈循环\r\n\r\n**纠正**：\r\n```bash\r\n# 必须确认红灯\r\npython scripts/tdd_runner.py red tests/test_xxx.py\r\n\r\n# 期望输出：\r\n# {\"status\": \"pass\", \"message\": \"红灯 ✓ 测试按预期失败\"}\r\n\r\n# 如果测试通过了，说明测试写错了，需要修正\r\n```\r\n\r\n### 6. 过度重构\r\n\r\n**症状**：\r\n- 在 GREEN 阶段就开始重构\r\n- 重构时改变了功能\r\n- 重构后测试失败，但不修复\r\n\r\n**危害**：\r\n- 混淆了\"让测试通过\"和\"优化代码\"\r\n- 重构引入新 bug\r\n- 无法区分\"功能变更\"和\"代码改进\"\r\n\r\n**纠正**：\r\n```\r\nRED → GREEN → (commit) → REFACTOR → (commit)\r\n\r\n# 每个阶段独立提交\r\ngit commit -m \"test: add failing test for xxx\" # RED\r\ngit commit -m \"feat: implement xxx\" # GREEN\r\ngit commit -m \"refactor: simplify xxx\" # REFACTOR\r\n```\r\n\r\n### 7. 测试覆盖率崇拜\r\n\r\n**症状**：\r\n- 追求 100% 覆盖率\r\n- 为每一行代码写测试\r\n- 测试数量远超代码数量\r\n\r\n**危害**：\r\n- 测试维护成本高\r\n- 测试运行时间长\r\n- 低价值测试（如测试 getter/setter）\r\n\r\n**纠正**：\r\n- 关注关键路径和边界条件\r\n- 为行为写测试，不为实现写测试\r\n- 接受合理的覆盖率（80-90%）\r\n\r\n## TDD 检查清单\r\n\r\n在每次编码前，确认：\r\n\r\n- [ ] 我是否先写了测试？\r\n- [ ] 测试是否失败了（红灯）？\r\n- [ ] 我是否只写了让测试通过的最少代码？\r\n- [ ] 测试是否通过了（绿灯）？\r\n- [ ] 我是否在绿灯后才开始重构？\r\n- [ ] 重构后测试是否仍然通过？\r\n\r\n## 工具使用\r\n\r\n```bash\r\n# 红灯阶段\r\npython scripts/tdd_runner.py red tests/test_xxx.py\r\n\r\n# 绿灯阶段\r\npython scripts/tdd_runner.py green tests/test_xxx.py\r\n\r\n# 完整循环\r\npython scripts/tdd_runner.py cycle tests/test_xxx.py src/xxx.py\r\n\r\n# 强制 TDD 检查\r\npython scripts/tdd_runner.py strict --check --src-dir src --test-dir tests\r\n```\r\n\r\n## 何时跳过 TDD\r\n\r\nTDD 不是万能的，以下场景可以跳过：\r\n\r\n1. **原型/实验代码**：快速验证想法，不需要测试\r\n2. **简单脚本**：一次性脚本，不会复用\r\n3. **UI 代码**：视觉验证比单元测试更重要\r\n4. **配置变更**：纯配置修改，没有逻辑\r\n\r\n**判断标准**：如果代码会被复用、会被其他人使用、或者包含关键业务逻辑，就应该写测试。\n\nFile v13.0.0:references/workflow-examples.md\n\n# 工作流示例\r\n\r\n> coding-framework 的常见使用场景和工作流示例。\r\n\r\n## 模式 1：快速编码\r\n\r\n### 场景：用户要求写一个简单的 HTTP 服务\r\n\r\n```\r\n用户：用 Python 写一个 HTTP 服务，返回 JSON 格式的当前时间\r\n\r\ncoding-framework 处理流程：\r\n1. 应用 Ponytail 决策阶梯\r\n - 需要存在吗？→ 是，用户明确要求\r\n - 代码库已有？→ 检查... 无\r\n - 标准库能做？→ 是！http.server + json + datetime\r\n - 停止在第 3 级\r\n2. 输出最简实现\r\n3. 标注：skipped: 路由框架/中间件/日志, add when 需要多端点或认证时\r\n```\r\n\r\n### 场景：用户要求重构一个模块\r\n\r\n```\r\n用户：重构 src/payment.py，代码太乱了\r\n\r\ncoding-framework 处理流程：\r\n1. 评估复杂度 → 需要读取文件 + 分析 + 重写 → 复杂任务\r\n2. spawn coding-agent（code-reviewer 先审查）\r\n3. 根据审查结果制定重构计划\r\n4. 如果重构涉及多轮改进 → 切换到迭代模式\r\n```\r\n\r\n## 模式 2：代理审查\r\n\r\n### 场景：用户提交代码审查请求\r\n\r\n```\r\n用户：审查 src/api/ 目录的代码\r\n\r\ncoding-framework 处理流程：\r\n1. 解析目标：src/api/ 目录\r\n2. 分析代码特征 → 涉及 API 端点、认证、数据库操作\r\n3. 自动选择代理：\r\n - code-reviewer（代码质量）\r\n - security-auditor（API 安全）\r\n - performance-analyst（N+1 查询检测）\r\n4. 运行 review-orchestrator.py --auto-select\r\n5. 并行 spawn 3 个子代理\r\n6. 收集结果 → 置信度过滤 → 冲突解决\r\n7. 生成汇总报告\r\n```\r\n\r\n### 场景：只做安全审查\r\n\r\n```\r\n用户：检查这段代码有没有安全漏洞\r\n\r\ncoding-framework 处理流程：\r\n1. 识别：安全审查请求\r\n2. 选择代理：security-auditor\r\n3. spawn 单个子代理\r\n4. 扫描 25 种安全模式\r\n5. 输出安全审计报告\r\n```\r\n\r\n## 模式 3：迭代改进\r\n\r\n### 场景：性能优化\r\n\r\n```\r\n用户：这个接口响应太慢了，帮我优化\r\n\r\ncoding-framework 处理流程：\r\n1. 初始化迭代循环\r\n python scripts/loop-controller.py init \\\r\n --name \"optimize-api\" \\\r\n --mode adaptive \\\r\n --max 10 \\\r\n --patience 3\r\n2. 第 1 轮：性能分析 → 发现 N+1 查询\r\n3. 修复 N+1 → 更新状态\r\n4. 第 2 轮：再次分析 → 发现缺少索引\r\n5. 添加索引 → 更新状态\r\n6. 第 3 轮：再次分析 → 无明显改进\r\n7. 第 4 轮：仍无改进 → patience 触发 → 停止\r\n8. 输出优化报告\r\n```\r\n\r\n### 场景：测试修复\r\n\r\n```\r\n用户：测试一直失败，帮我修到全部通过\r\n\r\ncoding-framework 处理流程：\r\n1. 初始化迭代循环\r\n python scripts/loop-controller.py init \\\r\n --name \"fix-tests\" \\\r\n --mode max \\\r\n --max 15 \\\r\n --condition \"regex:All tests passed\"\r\n2. 循环：运行测试 → 分析失败 → 修复 → 验证\r\n3. 匹配完成条件 → 退出循环\r\n```\r\n\r\n## 模式 4：安全守卫\r\n\r\n### 场景：用户执行危险命令\r\n\r\n```\r\n用户执行：rm -rf /tmp/build\r\n\r\ncoding-framework 处理流程：\r\n1. PreExec hook 触发\r\n2. pre-exec-check.sh 扫描命令\r\n3. 匹配规则：dangerous-commands (critical)\r\n4. 决策：block\r\n5. 输出：\r\n {\r\n \"decision\": \"block\",\r\n \"message\": \"命令被规则 'dangerous-commands' 阻止\",\r\n \"matched_rules\": [\"dangerous-commands\"]\r\n }\r\n6. 报告用户，建议替代方案：trash /tmp/build\r\n```\r\n\r\n### 场景：正常命令执行\r\n\r\n```\r\n用户执行：python test_main.py\r\n\r\ncoding-framework 处理流程：\r\n1. PreExec hook 触发\r\n2. pre-exec-check.sh 扫描命令\r\n3. 无匹配规则\r\n4. 决策：allow\r\n5. 命令执行\r\n6. PostExec hook 记录日志\r\n```\r\n\r\n## 组合工作流\r\n\r\n### 场景：完整的编码 + 审查 + 优化流程\r\n\r\n```\r\n1. 快速编码（模式 1）\r\n → 写代码，应用 Ponytail 阶梯\r\n\r\n2. 代理审查（模式 2）\r\n → 并行审查：code-reviewer + security-auditor\r\n → 发现问题 → 修复\r\n\r\n3. 迭代改进（模式 3）\r\n → 性能优化循环\r\n → 直到满足条件\r\n\r\n4. 安全守卫（模式 4）\r\n → 全程保护，每次 exec 前检查\r\n```\r\n\r\n## 自定义工作流\r\n\r\n用户可以根据需要组合不同模式：\r\n\r\n```\r\n用户：帮我写一个新 API，写完做安全审查，然后优化性能\r\n\r\ncoding-framework：\r\n1. 模式 1 → 写代码\r\n2. 模式 2 → 安全审查（security-auditor）\r\n3. 模式 3 → 性能优化迭代\r\n4. 模式 4 → 全程安全守卫\r\n```\n\nFile v13.0.0:references/worktree-guide.md\n\n# Git Worktree 使用指南\r\n\r\n> 借鉴 Superpowers 的隔离开发设计，在模式 5（工作流编排）中实现主分支不受影响的隔离开发。\r\n\r\n## 什么是 Git Worktree\r\n\r\nGit worktree 允许你从同一个仓库创建多个工作目录，每个工作目录独立检出一个分支。这意味着你可以：\r\n\r\n- 在主分支保持不变的情况下，在新分支上开发功能\r\n- 同时处理多个功能，快速切换\r\n- 避免 `git stash` 的混乱\r\n\r\n## 目录结构\r\n\r\n```\r\nworkspace/\r\n├── .worktrees/ # 所有隔离工作区\r\n│ ├── feature-x/ # feature-x 的独立工作区\r\n│ │ ├── .worktree-metadata.json\r\n│ │ ├── src/\r\n│ │ └── ...\r\n│ └── feature-y/\r\n├── src/ # 主工作区（master 分支）\r\n└── ...\r\n```\r\n\r\n## 工作流\r\n\r\n### 1. 开始新功能\r\n\r\n```bash\r\n# 创建隔离工作区（自动创建同名分支）\r\npython scripts/worktree-manager.py create --name \"feature-login\"\r\n\r\n# 输出：\r\n# {\r\n# \"status\": \"success\",\r\n# \"path\": \".worktrees/feature-login\",\r\n# \"branch\": \"feature-login\"\r\n# }\r\n```\r\n\r\n### 2. 在隔离环境中开发\r\n\r\n```bash\r\n# 切换到 worktree 目录\r\ncd .worktrees/feature-login\r\n\r\n# 正常开发，所有修改都在 feature-login 分支\r\n# 主工作区（master）不受影响\r\n```\r\n\r\n### 3. 查看状态\r\n\r\n```bash\r\n# 列出所有 worktree\r\npython scripts/worktree-manager.py list\r\n\r\n# 查看特定 worktree 的 git 状态\r\npython scripts/worktree-manager.py status --name \"feature-login\"\r\n```\r\n\r\n### 4. 完成功能\r\n\r\n```bash\r\n# 回到主工作区\r\ncd ../..\r\n\r\n# 合并功能分支\r\ngit merge feature-login\r\n\r\n# 清理已合并的 worktree\r\npython scripts/worktree-manager.py cleanup --merged\r\n```\r\n\r\n### 5. 放弃功能\r\n\r\n```bash\r\n# 删除 worktree 和分支\r\ngit worktree remove .worktrees/feature-login\r\ngit branch -D feature-login\r\n```\r\n\r\n## 使用场景\r\n\r\n### 场景 1：复杂功能开发\r\n\r\n当你需要开发一个涉及多文件修改的功能时：\r\n\r\n1. 创建 worktree：`worktree-manager.py create --name \"feature-x\"`\r\n2. 在 worktree 中开发，主分支保持干净\r\n3. 完成后合并或丢弃\r\n\r\n### 场景 2：并行开发\r\n\r\n当你需要同时处理多个任务时：\r\n\r\n```bash\r\n# 创建多个 worktree\r\nworktree-manager.py create --name \"feature-a\"\r\nworktree-manager.py create --name \"feature-b\"\r\n\r\n# 在不同 worktree 中并行开发\r\n# 快速切换：worktree-manager.py switch --name \"feature-a\"\r\n```\r\n\r\n### 场景 3：实验性修改\r\n\r\n当你想尝试一种实现方式，但不确定是否可行时：\r\n\r\n1. 创建 worktree\r\n2. 在 worktree 中实验\r\n3. 如果不行，直接丢弃（不影响主分支）\r\n\r\n## 注意事项\r\n\r\n1. **磁盘空间**：每个 worktree 都是完整的工作目录，会占用额外磁盘空间\r\n2. **依赖安装**：每个 worktree 需要独立安装依赖（如 `npm install`）\r\n3. **定期清理**：使用 `cleanup --merged` 清理已合并的 worktree\r\n4. **分支命名**：worktree 名称就是分支名称，建议使用 `feature-xxx` 格式\r\n\r\n## 与 coding-framework 集成\r\n\r\n在模式 5（工作流编排）中，worktree 创建是自动的：\r\n\r\n```\r\n用户: \"实现用户登录功能\"\r\n ↓\r\ndaily-agent 分类: 编码任务\r\n ↓\r\ncoding-framework 模式 5:\r\n 1. 任务分类 → backend\r\n 2. 规划阶段 → 生成实现计划\r\n 3. 用户确认\r\n 4. 🌳 创建 worktree → worktree-manager.py create --name \"feature-login\"\r\n 5. 在 worktree 中执行\r\n 6. 审查 → 多代理审查\r\n 7. 优化\r\n 8. 交付确认 → 合并/保留/丢弃\r\n```\r\n\r\n## 故障排除\r\n\r\n### 问题：worktree 创建失败\r\n\r\n```\r\n错误: 'feature-x' already exists\r\n```\r\n\r\n**解决**：worktree 已存在，使用 `switch` 切换或先 `cleanup`\r\n\r\n### 问题：合并冲突\r\n\r\n```bash\r\n# 在 worktree 中解决冲突\r\ncd .worktrees/feature-x\r\ngit merge master # 或 rebase\r\n# 解决冲突后\r\ngit add .\r\ngit commit\r\n```\r\n\r\n### 问题：磁盘空间不足\r\n\r\n```bash\r\n# 清理所有已合并的 worktree\r\nworktree-manager.py cleanup --merged\r\n\r\n# 或手动删除特定 worktree\r\ngit worktree remove .worktrees/old-feature\r\n```\n\nFile v13.0.0:CONTRIBUTING.md\n\n# coding-framework 扩展指南\r\n\r\n> 版本: 10.1.0 | 更新日期: 2026-06-29\r\n\r\n本文档说明如何扩展 coding-framework 的功能。\r\n\r\n---\r\n\r\n## 一、新增代理\r\n\r\n### 1.1 创建代理定义文件\r\n\r\n在 `agents/` 目录下创建 YAML 文件：\r\n\r\n```yaml\r\n# agents/i18n-checker.yaml\r\nname: i18n-checker\r\ndisplay_name: \"国际化检查员\"\r\ndescription: \"检查代码中的硬编码字符串、日期格式、货币等国际化问题\"\r\nmodel: sonnet\r\ncolor: purple\r\n\r\n# 工具权限（最小权限原则）\r\ntools:\r\n - Read\r\n - Grep\r\n - Glob\r\n\r\n# 触发示例\r\ntrigger_examples:\r\n - \"检查国际化\"\r\n - \"i18n review\"\r\n - \"有没有硬编码字符串\"\r\n\r\n# 系统提示\r\nsystem_prompt: |\r\n 你是一个专业的国际化检查员。你的职责是检查代码中的国际化问题。\r\n \r\n ## 检查维度\r\n \r\n 1. **硬编码字符串**: 用户可见的文本是否使用 i18n 函数\r\n 2. **日期格式**: 是否使用本地化日期格式\r\n 3. **货币格式**: 是否使用 Intl.NumberFormat 或类似工具\r\n 4. **时区处理**: 是否正确处理时区\r\n \r\n ## 输出格式\r\n \r\n ```markdown\r\n ### 国际化检查报告\r\n \r\n #### 发现的问题\r\n 1. [文件:行号] 硬编码字符串: \"Submit\"\r\n 建议: 使用 i18n.t('submit')\r\n \r\n #### 评分\r\n - 国际化就绪度: X/10\r\n ```\r\n```\r\n\r\n### 1.2 注册代理\r\n\r\n在 `.coding-framework.yml` 中注册（可选）：\r\n\r\n```yaml\r\nagents:\r\n custom_agents:\r\n - i18n-checker\r\n```\r\n\r\n### 1.3 更新职责矩阵\r\n\r\n在 `SKILL.md` 的\"代理职责矩阵\"中添加新代理的职责。\r\n\r\n---\r\n\r\n## 二、新增安全模式\r\n\r\n### 2.1 添加模式定义\r\n\r\n在 `rules/security-patterns.md` 中添加：\r\n\r\n```markdown\r\n### 26. 不安全的文件上传\r\n\r\n**严重度**: high\r\n\r\n**模式**:\r\n- 未验证文件类型\r\n- 未限制文件大小\r\n- 直接保存到公开目录\r\n\r\n**检查规则**:\r\n```regex\r\n# Python Flask\r\nrequest\\.files\\[.*\\]\\.save\\(\r\n# Node.js multer\r\nupload\\.single\\(.*\\)\\(req, res\r\n```\r\n\r\n**修复建议**:\r\n1. 验证文件 MIME 类型\r\n2. 限制文件大小\r\n3. 使用随机文件名\r\n4. 保存到非公开目录\r\n```\r\n\r\n### 2.2 添加匹配规则\r\n\r\n在 `rules/security-rules.md` 中添加：\r\n\r\n```yaml\r\n- name: insecure-file-upload\r\n enabled: true\r\n severity: high\r\n matcher:\r\n pattern: 'request\\.files\\[.*\\]\\.save\\('\r\n type: regex\r\n action:\r\n type: block\r\n message: \"检测到不安全的文件上传，请验证文件类型和大小\"\r\n```\r\n\r\n### 2.3 自动加载\r\n\r\n`pre-exec-check.sh` 会自动加载 `rules/` 目录下的所有规则文件，无需修改脚本。\r\n\r\n---\r\n\r\n## 三、新增迭代模式\r\n\r\n### 3.1 修改 loop-controller.py\r\n\r\n在 `scripts/loop-controller.py` 中添加新模式：\r\n\r\n```python\r\nclass IterationMode(Enum):\r\n FIXED = \"fixed\"\r\n MAX = \"max\"\r\n ADAPTIVE = \"adaptive\"\r\n CUSTOM = \"custom\" # 新增\r\n\r\ndef check_custom_mode(self, state: dict) -> bool:\r\n \"\"\"自定义模式检查逻辑\"\"\"\r\n # 你的实现\r\n current_iteration = state.get(\"iteration\", 0)\r\n custom_condition = self.evaluate_custom_condition(state)\r\n return current_iteration < state[\"max\"] and not custom_condition\r\n```\r\n\r\n### 3.2 更新文档\r\n\r\n在 `references/iteration-patterns.md` 中添加新模式说明。\r\n\r\n---\r\n\r\n## 四、新增 Hook 事件\r\n\r\n### 4.1 创建 Hook 脚本\r\n\r\n在 `hooks/` 目录下创建脚本：\r\n\r\n```bash\r\n#!/bin/bash\r\n# hooks/pre-commit-check.sh\r\n\r\n# 从 stdin 读取 JSON 事件数据\r\nEVENT_DATA=$(cat)\r\n\r\n# 提取字段\r\nif command -v jq &>/dev/null; then\r\n COMMIT_MSG=$(echo \"$EVENT_DATA\" | jq -r '.commitMessage // \"\"')\r\nelse\r\n COMMIT_MSG=$(echo \"$EVENT_DATA\" | grep -o '\"commitMessage\"[[:space:]]*:[[:space:]]*\"[^\"]*\"' | head -1 | sed 's/.*: *\"//;s/\"$//')\r\nfi\r\n\r\n# 检查逻辑\r\nif [[ \"$COMMIT_MSG\" =~ ^(WIP|wip) ]]; then\r\n echo '{\"decision\": \"warn\", \"message\": \"检测到 WIP 提交，请考虑 squash\"}'\r\nelse\r\n echo '{\"decision\": \"allow\", \"message\": \"\"}'\r\nfi\r\n```\r\n\r\n### 4.2 注册事件\r\n\r\n在 `references/hook-system.md` 中记录新事件。\r\n\r\n---\r\n\r\n## 五、贡献规范\r\n\r\n### 5.1 代码风格\r\n\r\n- Python: 遵循 PEP 8，使用类型提示\r\n- Shell: 使用 `set -euo pipefail`\r\n- YAML: 2 空格缩进\r\n- Markdown: 中文使用全角标点\r\n\r\n### 5.2 测试要求\r\n\r\n新增功能必须包含：\r\n- 单元测试（Python 脚本）\r\n- 使用示例（文档）\r\n- 边界情况处理\r\n\r\n### 5.3 提交格式\r\n\r\n```\r\n(): \r\n\r\ntype: feat/fix/docs/style/refactor/test\r\nscope: agent/hook/iteration/security/docs\r\nsubject: 简短描述\r\n```\r\n\r\n示例：\r\n```\r\nfeat(agent): 添加 i18n-checker 代理\r\nfix(loop-controller): 修复并发状态冲突\r\ndocs(security): 更新安全模式文档\r\n```\r\n\r\n---\r\n\r\n## 六、常见问题\r\n\r\n### Q: 如何在不修改核心代码的情况下添加自定义规则？\r\n\r\nA: 创建 `rules/custom-security-patterns.md`，在 `.coding-framework.yml` 中配置：\r\n\r\n```yaml\r\nsecurity:\r\n custom_rules: rules/custom-security-patterns.md\r\n```\r\n\r\n### Q: 如何让我的代理只在特定场景触发？\r\n\r\nA: 在代理 YAML 的 `trigger_examples` 中精确定义触发关键词，并在 `system_prompt` 中明确职责边界。\r\n\r\n### Q: 迭代循环意外中断，如何恢复？\r\n\r\nA: 使用 `--force` 参数重置状态：\r\n\r\n```bash\r\npython scripts/loop-controller.py init --name \"task\" --mode max --max 10 --force\r\n```\r\n\r\n---\r\n\r\n## 七、联系与支持\r\n\r\n- 问题反馈: 在 OpenClaw 工作区提交 Issue\r\n- 讨论: OpenClaw Discord #coding-framework 频道\r\n\r\n---\r\n\r\n*本文档随 coding-framework 版本更新，请定期查看最新内容。*\n\nArchive v12.0.1: 41 files, 132976 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/backend-reviewer.yaml (2417b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/explore.yaml (1953b), agents/frontend-reviewer.yaml (2200b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/python-reviewer.yaml (1542b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), agents/typescript-reviewer.yaml (1663b), CONTRIBUTING.md (5347b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (5768b), plans/README.md (222b), references/agent-system.md (3873b), references/external-agents.md (5245b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/tdd-anti-patterns.md (5140b), references/workflow-examples.md (4292b), references/worktree-guide.md (4020b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/check-environment.py (9612b), scripts/dag-scheduler.py (20140b), scripts/instinct-manager.py (15687b), scripts/loop-controller.py (49784b), scripts/review-orchestrator.py (19367b), scripts/spec-init.py (9132b), scripts/tdd_runner.py (13193b), scripts/workflow-orchestrator.py (15221b), scripts/worktree-manager.py (10838b), skill-card.md (2939b), SKILL.md (84996b), _meta.json (136b)\n\nFile v12.0.1:SKILL.md\n\n---\nname: coding-framework\ndescription: \"Orchestrate the complete coding workflow �� stage detection, design gate, implementation, review, and verification. Use when starting any programming task, writing code, debugging, reviewing, or deploying.\"\nversion: 12.3.0\ndependencies:\n skills: [\"code-review\", \"brainstorming\", \"systematic-debugging\"] # v12.1: 设计门控 + 系统化调�?---\n\n# Coding Framework �?统一编程框架 v12.2.0\n\n## 你是�?\n你是一个资深编程框架，整合了业界最佳实践：\n- Claude Code �?Hook 事件系统和多代理审查\n- Claude Plugins Official 的安全审核和渐进式披�?- OpenAI Codex 的标准化代理定义和安全沙�?- Ponytail �?YAGNI 决策阶梯和代码精简哲学\n- **Karpathy 四原�?*（v11.5 新增）：LLM 编码行为准则\n- **Anthropic 官方技能体�?*（v11.6 新增）：24 个开发阶段技能路�?\n---\n\n## Step 0: 开发阶段检测（v11.6 新增�?\n> 参考：`using-agent-skills` skill 的开发阶段决策树\n\n在开始编码前，先检测当前任务处于哪个开发阶段，加载对应的技能：\n\n```\n任务到达\n �? ├── 还不知道想要什么？ ──────�?interview-me\n ├── 有粗略概念，需要变体？ �?idea-refine\n ├── 新项�?功能/变更�?──�?spec-driven-development\n ├── 有规格，需要任务？ ──────�?planning-and-task-breakdown\n ├── 实现代码�?────────────�?incremental-implementation\n �? ├── UI 工作�?─────────────────�?frontend-design\n �? ├── API 工作�?────────────────�?api-and-interface-design\n �? ├── 需要更好的上下文？ ─────�?context-engineering\n �? ├── 需要文档验证的代码�?───�?source-driven-development\n �? └── 高风�?不熟悉的代码�?──�?doubt-driven-development\n ├── 编写/运行测试�?────────�?test-driven-development\n �? └── 基于浏览器？ ───────────�?browser-testing-with-devtools\n ├── 出问题了�?──────────────�?debugging-and-error-recovery\n ├── 审查代码�?───────────────�?code-review\n �? ├── 太复杂？ ─────────────�?code-simplifier\n �? ├── 安全问题�?───────�?security-and-hardening\n �? └── 性能问题�?───�?performance-optimization\n ├── 提交/分支�?─────────�?git-workflow-and-versioning\n ├── CI/CD 管道工作�?──────────�?ci-cd-and-automation\n ├── 弃用/迁移�?────────�?deprecation-and-migration\n ├── 写文�?ADR�?───────────�?documentation-and-adrs\n ├── 添加日志/指标/告警�?───�?observability-and-instrumentation\n └── 部署/发布�?─────────�?shipping-and-launch\n```\n\n### 阶段检测规�?\n**检测关键词**�?\n| 阶段 | 关键�?| 加载技�?|\n|------|--------|---------|\n| 需求澄�?| 想要什么、需求、用户故�?| interview-me |\n| 想法精炼 | 想法、概念、变体、头脑风�?| idea-refine |\n| 规格定义 | 规格、PRD、需求文�?| spec-driven-development |\n| 任务分解 | 任务、拆解、计�?| planning-and-task-breakdown |\n| 代码实现 | 实现、编码、开�?| incremental-implementation |\n| UI 开�?| UI、界面、组件、样�?| frontend-design |\n| API 开�?| API、接口、端�?| api-and-interface-design |\n| 测试编写 | 测试、TDD、单元测�?| test-driven-development |\n| 调试修复 | 调试、bug、修�?| debugging-and-error-recovery |\n| 代码审查 | 审查、review、检�?| code-review |\n| 代码简�?| 简化、重构、优化结�?| code-simplifier |\n| 安全加固 | 安全、漏洞、加�?| security-and-hardening |\n| 性能优化 | 性能、优化、加�?| performance-optimization |\n| Git 操作 | 提交、分支、合�?| git-workflow-and-versioning |\n| CI/CD | CI、CD、流水线 | ci-cd-and-automation |\n| 弃用迁移 | 弃用、迁移、升�?| deprecation-and-migration |\n| 文档编写 | 文档、ADR、说�?| documentation-and-adrs |\n| 可观测�?| 日志、指标、监�?| observability-and-instrumentation |\n| 部署发布 | 部署、发布、上�?| shipping-and-launch |\n\n### 🔴 防跳过机制：Red Flags 表格（v11.7 新增�?\n> 参考：Superpowers using-superpowers skill �?Red Flags 设计\n> \n> **核心原则**：即使只�?1% 的可能性适用某个技能，也必须调用�?\n以下思维模式意味着你正�?*合理化跳过技�?*——立即停止：\n\n| 你的想法 | 现实 |\n|---------|------|\n| \"这只是个简单修�? | 简单修改也可能引入 bug。检查技能�?|\n| \"我需要先了解更多上下�? | 技能告诉你**如何**探索。先检查技能�?|\n| \"让我快速看看代�? | 代码缺乏对话上下文。先检查技能�?|\n| \"这个任务不需要正式技�? | 如果有对应技能，就用它�?|\n| \"我记得这个技�? | 技能会演进。读当前版本�?|\n| \"技能太小题大做�? | 简单的事会变复杂。用它�?|\n| \"我先做这一件事\" | 做事**之前**先检查技能�?|\n| \"这看起来很有生产�? | 无纪律的行动浪费时间。技能防止这个�?|\n| \"我知道那是什么意�? | 知道概念 �?使用技能。调用它�?|\n| \"这是内部修改，不需要走流程\" | 内部修改也是修改。检查技能�?|\n| \"我很有信心，不用验证\" | 信心 �?证据。运行验证�?|\n| \"应该能过\" | 运行命令，看输出�?|\n| \"看起来没问题\" | 运行 lint/build，看 exit code�?|\n| \"Agent 说成功了\" | 独立验证：检�?VCS diff，确认变更�?|\n\n**核心原则**：违反规则的字面意思就是违反规则的精神�?\n**Red Flags 自检**：如果你发现自己在想以上任何一句话 �?STOP，先检查技�?运行验证�?\n**自动触发自检的场�?*（v12.0 新增）：\n- AI 想跳过某个步骤时\n- AI 想说\"应该\" / \"大概\" / \"可能\"�?- AI 准备调用实现技能但未检查设计时\n- AI 声称\"测试通过\"但未运行测试命令�?\n**1% 规则**：如果你认为�?1% 的可能性某个技能适用�?*必须调用�?*。如果最终发现不适用，你可以不使用它。但跳过检查本身就是违规�?\n**技能优先级**：流程技能（spec-driven、planning、debugging）先于实现技能（frontend-design、api-design）�?\n---\n\n### 多阶段任务处�?\n如果任务跨越多个阶段，按顺序加载�?\n**示例**：新功能开�?```\n1. spec-driven-development �?定义规格\n2. planning-and-task-breakdown �?拆解任务\n3. incremental-implementation �?逐片实现\n4. test-driven-development �?编写测试\n5. code-review �?代码审查\n6. git-workflow-and-versioning �?提交代码\n```\n\n### 阶段检测失�?\n如果无法确定阶段，询问用户：\n\n> \"这个任务处于哪个开发阶段？\n> - 需求澄清（还不清楚要做什么）\n> - 规格定义（已有概念，需要详细规格）\n> - 代码实现（规格已定，开始编码）\n> - 测试编写（代码已写，需要测试）\n> - 代码审查（测试通过，需要审查）\n> - 部署发布（审查完成，准备上线�?\n\n---\n\n## Step 0.5: 设计门控（v12.1 新增，P0�?\n> 来源：Superpowers brainstorming �?HARD-GATE 设计\n> 核心原则�?*设计未批准，不写代码�?* 无论任务多简单�?\n### 铁律\n\n```\nNO CODE BEFORE DESIGN APPROVAL\n```\n\n如果任务涉及**创建新功能、修改现有行为、构建组�?*，必须先完成设计审批，才能进入编码阶段�?\n### 门控流程\n\n```\nStep 0: 阶段检测完�? �?检测：任务是否涉及创建/修改功能�? �? ├─ 否（纯查�?阅读/调试现有代码�?�?跳过门控，继�? �? └─ 是（新功�?行为修改/组件构建�? �? 强制加载 brainstorming skill\n �? 执行 brainstorming 流程�? 1. 探索项目上下�? 2. 逐一澄清问题（目�?约束/成功标准�? 3. 提出 2-3 个方�?+ 权衡\n 4. 展示设计，等待用户批�? �? 用户批准�? ├─ �?�?修订设计，重新展�? └─ �?�?记录设计决策 �?进入编码阶段\n```\n\n### 触发条件（满足任一即触发）\n\n| 关键�?| 示例 |\n|--------|------|\n| 实现/开�?创建 | \"实现用户登录功能\" |\n| 添加/新增 | \"添加一个配置面�? |\n| 修改行为 | \"把这里的逻辑改成...\" |\n| 构建/搭建 | \"搭建一�?API 服务\" |\n| 重构 | \"重构这个模块\" |\n\n### 跳过条件（全部满足才跳过�?\n- 任务纯粹�?*阅读/查询/分析**（不涉及文件修改�?- 任务是对**已有设计�?bug 修复**（设计已存在�?- 用户显式�?直接写，不需要设�?\n\n### 设计审批记录\n\n设计批准后，记录�?`.superpowers/design-approval.md`�?\n```markdown\n# Design Approval\nDate: YYYY-MM-DD HH:MM\nTask: {任务描述}\nDesign: {设计摘要}\nStatus: APPROVED\nUser confirmed: \"yes\" / \"approved\" / \"go ahead\"\n```\n\n### 反模式警�?\n以下思维 = 你正在合理化跳过设计门控�?\n| 你的想法 | 现实 |\n|---------|------|\n| \"这太简单了，不需要设�? | 简单项目正是未经审视假设最浪费时间的地�?|\n| \"我知道用户想要什�? | 知道 �?确认。展示设计，获得批准�?|\n| \"设计会拖慢速度\" | 返工更慢�?|\n| \"只是个小改动\" | 小改动也可能破坏现有行为。确认设计�?|\n| \"用户很急，先写再说\" | 写错了更急�?|\n\n### �?brainstorming skill 的关�?\n- coding-framework Step 0.5 �?*门控**（决定是否需要设计审批）\n- brainstorming skill �?*流程**（如何完成设计审批）\n- Step 0.5 检测到需要设�?�?加载 brainstorming skill �?按其流程执行\n- brainstorming 完成�?�?回到 coding-framework 继续编码阶段\n\n---\n\n## 技能加载流�?\nStep 0 检测到阶段 �?加载对应 skill �?执行流程 �?进入下一阶段。详�?Step 0 决策树�?\n## Karpathy 四原则（v11.5 新增�?\n> 来源：Andrej Karpathy（前 Tesla AI 总监）对 LLM 编码缺陷的观�?\n### 原则 1：编码前思考（Think Before Coding�?\n**不要假设，不要隐藏困惑，呈现权衡�?*\n\n编码前必须：\n- **明确陈述假设** �?如果不确定，先问而不是猜\n- **呈现多种解读** �?存在歧义时不要默默选一�?- **推回当有理由�?* �?如果有更简单的方案，说出来\n- **困惑时停�?* �?说清楚什么不清楚，然后问\n\n### 原则 2：简洁优先（Simplicity First�?\n**解决问题的最少代码，不做推测性实现�?*\n\n- 不添加未被要求的功能\n- 单次使用的代码不做抽�?- 不做未被要求�?灵活�?�?可配置�?\n- 不为不可能的场景做错误处�?- 200 行能�?50 行解�?�?重写\n\n**检验标�?*：一个资深工程师会说\"这太复杂�?吗？如果是，简化�?\n### 原则 3：精准修改（Surgical Changes�?\n**只动必须动的。只清理自己造成的混乱�?*\n\n编辑现有代码时：\n- 不要\"改进\"相邻的代码、注释或格式\n- 不要重构没坏的东�?- 匹配现有风格，即使你会用不同方式\n- 发现无关的死代码 �?提一下，不要�?\n当你的修改造成孤儿时：\n- 删除**你的修改**导致的未使用 import/变量/函数\n- 不要删除预先存在的死代码，除非被要求\n\n**检验标�?*：每一行改动都应该能直接追溯到用户的请求�?\n### 原则 4：目标驱动执行（Goal-Driven Execution�?\n**定义成功标准。循环直到验证通过�?*\n\n将命令式任务转化为可验证目标�?\n| 不要�?.. | 而是... |\n|-----------|---------|\n| \"添加验证\" | \"为无效输入写测试，然后让测试通过\" |\n| \"修复 bug\" | \"写一个复�?bug 的测试，然后让测试通过\" |\n| \"重构 X\" | \"确保重构前后测试都通过\" |\n\n多步骤任务，陈述简要计划：\n1. [步骤] �?验证：[检查点]\n2. [步骤] �?验证：[检查点]\n3. [步骤] �?验证：[检查点]\n\n**强成功标准让 LLM 能独立循环。弱标准�?让它能用\"）需要不断澄清�?*\n\n### 四原则生效的标志\n\n- diff 中更少的不必要改�?�?只有被要求的改动出现\n- 更少因过度复杂导致的重写 �?第一次就写简�?- 澄清问题在实现之�?�?而不是在犯错之后\n- 干净、最小化�?PR �?没有顺手重构�?改进\"\n\n---\n\n## 原则 5：Agent Brief 持久性（v12.3 新增�?\n> 来源：Matt Pocock �?triage skill �?\"持久性优于精确性——不引用文件路径/行号，只描述行为\"\n> 原因：spec 不会因为代码重构而失效，行为描述比路径引用更稳定�?\n### 铁律\n\n**生成�?task spec、任务描述、计划文件中，禁止引用具体文件路径和行号，只描述行为�?*\n\n### 规则\n\n1. **禁止** 在任务描述中引用具体文件路径（如 `src/components/Button.tsx`�?2. **禁止** 在任务描述中引用具体行号（如 `�?2行`�?3. **改为** 描述行为（如\"用户登录按钮组件\"�?处理支付的函�?�?\n### 示例对比\n\n| �?错误（路径引用） | �?正确（行为描述） |\n|---|---|\n| `修复 src/api/user.py �?27行的空指针异常` | `修复用户API中处理空用户ID时的空指针异常` |\n| `�?components/Header.tsx 中添加导航菜单` | `在页面顶部导航区域添加菜单组件` |\n| `修改 utils/auth.js �?validateToken 函数` | `修改令牌验证函数，增加过期时间检查` |\n\n### 适用范围\n\n- Plan Mode（模�?）生成的 plan.md\n- PDD .specs/ 中的 requirements.md、design.md、implementation-plan.md\n- DAG 任务�?task description\n- spawn 子代理时传入�?task 描述\n- 所有委派给子代理的任务 brief\n\n### 例外\n\n- 对话中用户明确要求看某个文件时，可以引用路径\n- 代码注释中可以引用路径（�?`// see src/config/routes.ts`�?- �?*任务描述/spec/计划**中始终用行为描述\n\n### 为什么有�?\n- 代码重构后，文件路径会变，但行为不变\n- 子代理自行定位文件，比硬编码路径更鲁�?- spec 的寿命远超单次实�?\n---\n\n## 工作模式\n\n### 模式 1：快速编码（v11.0 增强�?\n触发：用户要求写代码\n\n流程�?1. 应用 Ponytail 决策阶梯�? 级）\n2. 选择最简方案\n3. **强制验证循环**（v10.6 新增）：\n - 生成代码后立即执行编�?运行验证\n - 若失败，根据错误信息修复并重新验�? - 最�?3 次循环，仍失败则报告用户\n4. **🦆 自审（Rubber Duck Self-Review�?*（v10.9 新增，v11.3 增强，v11.5 加入 Karpathy 精准修改）：\n - 输出代码前，逐行扫描以下 5 个维度：\n - **安全**：eval/exec/SQL拼接/硬编码凭�?路径遍历\n - **逻辑**：边界条件（空列�?None/0/负数）、类型不匹配、未定义变量\n - **正确�?*：是否真正实现了需求（不是\"看起来对\"但逻辑偏移�? - **清晰�?*（v11.3，借鉴 Anthropic Code Simplifier）：\n - 嵌套复杂度：>2层嵌�?�?考虑提前返回或提取函�? - 命名一致性：变量/函数名是否清晰表达意�? - 冗余注释：删除描�?代码做什�?的注释（代码本身应该说明�? - 避免嵌套三元：`a ? b : c ? d : e` �?改用 if/else �?switch\n - 避免过度紧凑：一行代�?> 80字符且含多个操作 �?拆分\n - **精准修改**（v11.5，借鉴 Karpathy Surgical Changes）：\n - 每行改动都能追溯到用户请求吗�? - 是否\"改进\"了相邻的代码/注释/格式？→ 不要\n - 是否重构了没坏的东西？→ 不要\n - 是否匹配了现有风格？\n - 你的修改造成的孤儿（未使用import/变量）→ 清理\n - 预先存在的死代码 �?提一下，不要�? - 发现问题 �?修复后再输出\n - 无问�?�?直接输出\n - ⚠️ 这是\"内心独白�?审查，不 spawn 子代理，零额外开销\n - ⚠️ 清晰度检查不追求\"更少行数\"，而是\"更易�?\n5. **🧪 TDD 模式检�?*（v11.0 新增）：\n - 如果用户指定 `--strict-tdd` 或任务复杂度 �?medium�? - 先写测试（red）：`python scripts/tdd_runner.py red tests/test_xxx.py`\n - 再写实现（green）：`python scripts/tdd_runner.py green tests/test_xxx.py`\n - 重构（refactor�? - 运行严格检查：`python scripts/tdd_runner.py strict --check`\n - 如果检测到代码先于测试 �?删除代码，从测试重新开�? - ⚠️ 简单任务（trivial/small）可跳过 TDD\n6. **🔍 自动代码审查**（v11.2 新增，v11.7 升级为两阶段审查）：\n - 代码编写完成并通过验证后，自动调用 `code-review` skill 进行审查\n - **两阶段审查机�?*（v11.7，借鉴 Superpowers）：\n - **Stage 1: 任务级审�?*（每个任务完成后�? - 输入：diff + 任务 brief + 全局约束\n - 独立审查子代理，**不信任实现者报�?*\n - 检查：规格合规（Missing/Extra/Misunderstood�? 代码质量\n - 发现 Critical/Important �?派发修复子代�?�?重新审查\n - **Stage 2: 分支级审�?*（所有任务完成后，合并前�? - 输入：整个分�?diff + 计划/规格\n - 检查：跨任务一致�?+ 整体架构 + 生产就绪�? - 输出：准备合并？[Yes | No | With fixes]\n - 根据任务复杂度自动选择审查深度�? - trivial / small �?跳过（步�?的🦆自审已覆盖�? - medium �?Stage 1 任务级审查（独立子代理）\n - large �?Stage 1 + Stage 2 两阶段审�? - 用户显式�?不需要审�? / `--skip-review` �?跳过\n - **调用方式**：`read skills/code-review/SKILL.md` �?按其流程执行\n - **审查模板**：`skills/code-review/templates/task-reviewer-prompt.md` �?`branch-reviewer-prompt.md`\n7. **�?完成验证门控**（v12.1 新增，P1，融�?Step 8 Verification Before Completion）：\n - **铁律：没有新鲜验证证据，不能声称完成�?*\n - 在声称任务完成之前，必须执行该任务类型对应的验证命令�? - 代码实现 �?运行测试/lint/build（`pytest` / `npm test` / `cargo test`�? - 文档编写 �?检查渲染效果、链接有效�? - 配置修改 �?服务重启验证、配置语法检�? - 验证流程�? 步）�? 1. **IDENTIFY**：什么命令能证明这个声明�? 2. **RUN**：执行完整命令（fresh, complete�? 3. **READ**：完整输出，检�?exit code，统计失败数\n 4. **VERIFY**：输出是否确认了声明�? 5. **ONLY THEN**：做出声�?+ 附上证据\n - 禁止的表达：\n - �?\"应该能过\" �?�?[运行命令] [看到: 34/34 pass] \"全部通过\"\n - �?\"看起来没问题\" �?�?[运行lint] [看到: 0 errors] \"lint通过\"\n - �?\"我很有信�? �?�?信心 �?证据。运行验证�? - Red Flags（出现以下想�?�?STOP，先运行验证）：\n - \"应该能过\" / \"看起来没问题\" / \"我很有信�?\n - \"Agent 说成功了\" / \"部分检查就够了\"\n8. 输出格式：`[code] �?skipped: [X], add when [Y]`\n9. **📋 任务追踪**（v11.9 新增，借鉴 snarktank/ralph）：\n - 任务开始时创建 `tasks/task-{id}.json`（从模板复制�? - 每完成一�?story，更�?`passes: true` + `completed_at`\n - 所�?story 完成 �?任务状态变�?`done`\n - 任务完成后触发归档（�?自动归档机制\"�? - **模板位置**：`tasks/task-template.json`\n - **前端任务强制规则**（v11.9）：acceptance_criteria 必须包含浏览器验证步�?\n**强制验证规则**（v10.6 新增）：\n- Python：`python -m py_compile ` �?`python `\n- JavaScript/TypeScript：`node --check ` �?`tsc --noEmit`\n- Bash：`bash -n `\n- 其他语言：使用对应编译器/解释器验�?- 验证失败时，将完整错误信息传回模型修�?\n**Backpressure 三层门控**（v11.4 新增，借鉴 ralph-orchestrator）：\n\n代码通过编译验证后，自动运行门控检查：\n\n```\n代码生成 �?Gate 1（编译）�?Gate 2（测试）�?Gate 3（质量）�?输出\n �?失败 �?失败 �?失败\n 自动修复 自动修复 报告用户\n```\n\n| 门控 | 触发条件 | 检查内�?| 失败处理 |\n|------|---------|---------|---------|\n| Gate 1: 编译 | 始终运行 | py_compile / node --check / tsc | 自动修复3�?|\n| Gate 2: 测试 | 复杂�?�?medium 且有测试 | pytest / npm test | 自动修复3�?|\n| Gate 3: 质量 | 项目已配�?lint/typecheck | ruff / eslint / mypy / tsc --noEmit | lint 自动修复，typecheck 报告用户 |\n\n**执行方式**�?```bash\npython scripts/loop-controller.py gates --files \"src/main.py,src/utils.py\" --complexity medium\n```\n\n**跳过条件**：trivial/small 复杂度、项目无测试/lint 配置、用�?`--skip-gates`\n\n### 任务追踪机制（v11.9 新增，借鉴 snarktank/ralph�?\n**目的**：结构化追踪任务进度，支持断点续做和历史归档�?\n**文件结构**�?```\ntasks/\n├── task-template.json # 模板\n├── task-001.json # 具体任务\n└── task-002.json\n```\n\n**task.json 格式**�?```json\n{\n \"id\": \"task-001\",\n \"title\": \"集成 Firecrawl 云服�?,\n \"branch\": \"feature/firecrawl-integration\",\n \"created\": \"2026-07-08T10:00:00Z\",\n \"status\": \"done\",\n \"passes\": true,\n \"stories\": [\n {\n \"id\": \"story-1\",\n \"title\": \"创建 firecrawl skill\",\n \"passes\": true,\n \"acceptance_criteria\": [\"SKILL.md 完整\", \"测试 3/3 通过\", \"已提�?],\n \"completed_at\": \"2026-07-08T10:30:00Z\"\n }\n ],\n \"learnings\": [\"firecrawl-py API 与文档不完全一�?],\n \"archived\": false\n}\n```\n\n**状态流�?*�?```\npending �?in-progress �?done\n �? blocked（需要外部输入）\n```\n\n**触发规则**�?- 任务涉及 3+ 个文件修�?�?创建 task.json\n- 任务涉及多步�?�?每个步骤一�?story\n- 前端任务 �?acceptance_criteria 必须包含 \"Verify in browser\"\n\n### 自动归档机制（v11.9 新增，借鉴 snarktank/ralph�?\n**目的**：保留任务执行历史，支持复盘和知识积累�?\n**归档触发条件**�?- task.json 状态变�?`done`\n- 所�?story �?`passes: true`\n- 代码已提交到 git\n\n**归档目录结构**�?```\narchive/\n└── YYYY-MM-DD-feature-name/\n ├── task.json # 任务定义（从 tasks/ 复制�? ├── execution.log # 执行日志（从对话提取�? ├── learnings.md # 学习记录（从 .learnings/ 提取�? └── changes.md # 代码变更摘要（从 git log 提取�?```\n\n**归档流程**�?1. 创建归档目录：`archive/YYYY-MM-DD-{branch-name}/`\n2. 复制 task.json 到归档目�?3. 生成 changes.md：`git log --oneline {branch}..main`\n4. 提取 learnings：从 `.learnings/` 复制相关文件\n5. 更新 task.json：`archived: true`, `archived_at: timestamp`\n6. �?`tasks/` 删除原文件（可选，保留则不删除�?\n### 浏览器验证强制化（v11.9 新增，借鉴 snarktank/ralph�?\n**规则**：前端任务的 acceptance_criteria 必须包含浏览器验证步骤�?\n**检测条�?*（满足任一即视为前端任务）�?- 修改�?`.tsx/.jsx/.vue/.html/.css/.scss` 文件\n- 修改�?`src/components/` �?`src/pages/` 目录\n- 任务描述包含\"UI\"/\"前端\"/\"页面\"/\"组件\"\n\n**强制添加的验收标�?*�?```json\n{\n \"acceptance_criteria\": [\n \"...\",\n \"Verify in browser using browser-testing-with-devtools skill\"\n ]\n}\n```\n\n**执行方式**�?1. 检测到前端任务 �?自动注入浏览器验证步�?2. 代码审查时检�?�?缺少浏览器验�?�?标记�?Critical\n3. 执行浏览器验�?�?使用 `browser-testing-with-devtools` skill\n\n---\n\n### 模式 2：代理审�?\n触发：用户要求审查代�?/ \"review\"\n\n流程�?1. 根据代码特征选择代理�?-7 个）\n2. 并行 spawn 子代理执行审�?3. 按严重度分级阈值过滤发�?4. 合并去重，汇总为统一审查报告\n\n**置信度分级阈�?*（v10.1 改进）：\n\n| 严重�?| 置信度阈�?| 说明 |\n|--------|------------|------|\n| Critical | �?50 | 安全漏洞、数据丢失风险，低阈值确保不漏报 |\n| High | �?70 | 逻辑错误、性能问题 |\n| Medium | �?80 | 代码风格、最佳实�?|\n| Low | �?90 | 风格建议、可选优化，高阈值避免噪�?|\n\n**合并策略**（v10.1 新增）：\n- 按文�?行号归组\n- 同一位置多个代理报告 �?严重度取最�?- 合并建议文本，标记来源代�?- 冲突报告（同一位置不同结论）→ 保留两者，标记\"需人工判断\"\n\n### 模式 3：迭代改�?\n触发：用户要求优�?/ \"iterate\" / 性能问题\n\n流程�?1. 初始化迭代状态（loop-controller.py init�?2. 分析 �?改进 �?验证 �?循环\n3. 完成条件满足 �?退出（loop-controller.py complete�?\n### 模式 4：安全守�?\n触发：exec 命令执行�?\n流程�?1. PreExec 检查（25 种安全模式）\n2. 匹配 critical/high �?阻止 + 报告\n3. 匹配 medium �?允许 + 记录\n4. PostExec 日志\n\n## 决策�?\n```\n用户请求\n �? ├─ 写代�?�?模式 1（快速编码）\n �? ├─ 简单任�?�?直接�? �? └─ 复杂任务 �?spawn coding-agent\n �? ├─ 完成�?�?🔍 两阶段代码审查（v11.8，借鉴 Superpowers�? �? �? ├─ trivial/small �?跳过（自审已覆盖�? �? �? ├─ medium �?Stage 1: 任务级审查（独立子代理）\n �? �? └─ large �?Stage 1 + Stage 2: 分支级审�? �? �? └─ 不信任实现者报告，对照 diff 验证\n �? └─ 输出�?�?🚧 Backpressure 门控（v11.4�? �? ├─ Gate 1: 编译（始终）\n �? ├─ Gate 2: 测试（≥medium�? �? └─ Gate 3: 质量（已配置时）\n �? ├─ 审查代码 �?模式 2（代理审查）\n �? ├─ 小改�?�?单代理（code-reviewer�? �? └─ 大改�?�?多代理并�? �? └─ 或直接调�?code-review skill（v11.2 推荐�? �? ├─ 优化/调试 �?模式 3（迭代改进）\n �? └─ loop-controller 管理状�? �? ├─ 执行命令 �?模式 4（安全守卫）\n �? └─ hook-engine PreExec 检�? �? ├─ 完整开�?�?模式 5（工作流编排�? �? └─ 规划→执行→🔍两阶段审查（任务�?分支级）→🚧门控→优化\n �? ├─ 先做计划 �?模式 6（Plan Mode）（v10.9�? �? ├─ trivial~medium �?简�?plan.md\n �? └─ large/critical �?PDD .specs/ 目录（v11.4�? �? └─ requirements.md + design.md + implementation-plan.md\n �? ├─ 快速侦�?�?模式 7（Explore）（v10.9�? �? └─ spawn explore 代理 �?返回结论摘要\n �? ├─ 迭代循环 �?模式 8（Ralph Loop�? �? └─ hook-engine ralph_loop.py 管理迭代\n �? └─ 自我审查 �?模式 9（三角色切换）（v12.1�? └─ Implementer �?Reviewer �?Fixer，无需子代�?```\n\n## Ponytail 决策阶梯（编码前必过�?\n停止在第一个能 hold 住的层级�?\n1. **这需要存在吗�?* �?推测性需�?= 跳过（YAGNI�?2. **代码库已有？** �?复用 helper/util/type/pattern\n3. **标准库能做？** �?用它\n4. **平台原生功能�?* �?`` 优于 picker lib，CSS 优于 JS\n5. **已安装依赖能解决�?* �?用它，不新增依赖\n6. **一行搞定？** �?一�?7. **最小可行实�?* �?最后才写完整代�?\n### YAGNI 判断标准（v10.1 新增�?\n**跳过条件**（必须同时满足）�?- 未来需求概�?< 20%\n- 实现成本 > 5 行代�?- 跳过不会破坏当前抽象层次\n\n**不跳过（架构性需求白名单�?*�?- 接口定义（interface/type declaration�?- 插件机制入口\n- 错误码枚�?- 配置项骨�?\n**一行代码限�?*�?- 仅适用于语义清晰、无副作用的纯表达式\n- 不超�?80 字符\n- 可单步调�?\n**输出格式**�?```\n[code]\n�?skipped: [功能X] (reason: L3 - 标准库已提供) | add when [场景Y] confirmed\n```\n\n**不简化的边界**：输入验证（信任边界处）、防数据丢失的错误处理、安全措施、可访问性基础�?\n**Bug 修复**：修根因，不修症状。grep 所有调用者，在共享函数加 guard�?\n**标记简�?*：`// ponytail: global lock, per-account locks if throughput matters`\n\n## 安全守卫（exec 前必过）\n\n### 安全检查分层（v10.1 改进�?\n**命令级安全检�?*（pre-exec-check.sh 负责）：\n- 针对 shell 命令（rm、del、format 等）\n- 静态字符串匹配 + 正则\n- �?exec 执行前拦�?\n**代码级安全检�?*（security-auditor 代理负责）：\n- 针对源代码文件内容（eval、exec、SQL 拼接等）\n- 静态代码分�?- 在审查模式中检�?\n> 注意：`pre-exec-check.sh` 只处理命令级安全检查。代码中�?`eval()`、`exec()` 等风险由 security-auditor 代理在审查模式中处理，而非�?exec 前拦截�?\n### 25 种安全模式，4 级严重度�?\n| 级别 | 处理方式 |\n|------|----------|\n| critical | 阻止执行 + 报告用户 + 记录日志 |\n| high | 阻止执行 + 请求确认 + 记录日志 |\n| medium | 允许执行 + 记录告警日志 |\n| low | 记录日志，不干预 |\n\n模式类别：危险命令、注册表操作、账户管理、服务管理、计划任务、外部下载、批量操作、提权操作、敏感数据传输、代码执行风险、敏感信息泄露、路径遍历、SQL 注入、XSS 风险、不安全反序列化、硬编码凭证、不安全加密、资源泄漏、竞态条件、不安全随机数、日志注入、SSRF、XXE、不安全 CORS、依赖漏洞�?\n详细模式列表：`read references/security-patterns-detail.md`\n\n## 代码质量保障（v10.6 新增�?\n### 自检修正入口\n\n**强制规则**：最终输出代码前，必须通过自检�?\n**自检流程**�?1. 语法验证（编�?解释�?2. 静态分析（如有 linter�?3. 运行测试（如有测试套件）\n4. 安全检查（模式 4�?\n**自检命令**�?```bash\n# Python\npython -m py_compile && python -m pytest -v\n\n# JavaScript/TypeScript\nnode --check && npm test\n\n# Bash\nbash -n \n```\n\n**失败处理 �?3-Strike 错误协议**（v11.1 新增）：\n\n```\nATTEMPT 1: Diagnose & Fix\n �?读错误信息，找根�? �?应用针对性修�? \nATTEMPT 2: Alternative Approach\n �?同一错误？换方法\n �?换工具？换库�? �?绝不重复完全相同的失败操�?\nATTEMPT 3: Broader Rethink\n �?质疑假设\n �?搜索解决方案\n �?考虑更新计划\n\nAFTER 3 FAILURES: Escalate to User\n �?解释尝试了什�? �?分享具体错误\n �?请求指导\n```\n\n**核心规则**�?- `if action_failed: next_action != same_action`\n- 追踪尝试过的方法，变异策�?- 绝不隐藏错误并静默重�?\n### 静态分析工具（v10.6 新增�?\n**脚本**：`scripts/static_analysis.py`\n\n**用法**�?```bash\n# 自动检测语言�?linter\npython scripts/static_analysis.py src/main.py\n\n# 指定 linter\npython scripts/static_analysis.py src/app.js --linter eslint\n\n# JSON 输出（便于自动化�?python scripts/static_analysis.py src/main.py --format json\n\n# �?error 级别时退出码 1\npython scripts/static_analysis.py src/main.py --fail-on-error\n```\n\n**支持�?linter**�?\n| 语言 | linter | 安装方式 |\n|------|--------|----------|\n| Python | flake8 | `pip install flake8` |\n| Python | pylint | `pip install pylint` |\n| JavaScript/TS | eslint | `npm install -g eslint` |\n| Bash | shellcheck | 系统包管理器 |\n\n**集成规则**�?- 模式 1（快速编码）：生成代码后自动运行 `static_analysis.py`\n- 模式 2（代理审查）：code-reviewer 代理自动调用\n- error 级别告警必须修复，warning 需说明忽略原因\n\n### 分层验证栈（v10.6 新增�?\n**脚本**：`scripts/layered_validate.py`\n\n**三层定义**�?| �?| 名称 | 检查内�?| 失败处理 |\n|----|------|----------|----------|\n| L1 | 语法检�?| 编译/解析 | 立即停止，修复语�?|\n| L2 | 语义检�?| 类型、导入、作用域 | 停止，修复语�?|\n| L3 | 逻辑检�?| 运行测试 | 停止，修复逻辑 |\n\n**用法**�?```bash\n# 完整三层验证\npython scripts/layered_validate.py src/main.py\n\n# 跳过测试（仅语法+语义�?python scripts/layered_validate.py src/main.py --skip-tests\n\n# JSON 输出\npython scripts/layered_validate.py src/main.py --format json\n```\n\n**强制规则**�?- 任何代码生成后，必须通过 L1+L2 验证\n- L3 在有测试文件时强制执�?- 任一层失�?�?修复后重新验�?�?最�?3 次循�?\n### TDD 流程工具（v10.6 新增�?\n**脚本**：`scripts/tdd_runner.py`\n\n**TDD 红绿循环**�?```\n红灯（Red）→ 绿灯（Green）→ 重构（Refactor�?```\n\n**用法**�?```bash\n# 红灯阶段：运行测试，期望失败\npython scripts/tdd_runner.py red tests/test_main.py\n\n# 绿灯阶段：运行测试，期望通过\npython scripts/tdd_runner.py green tests/test_main.py\n\n# 完整循环\npython scripts/tdd_runner.py cycle tests/test_main.py src/main.py\n```\n\n**强制规则**（当用户要求 TDD 时）�?1. 先编写测试用�?2. 运行 `tdd_runner.py red` �?确认测试失败（红�?✓）\n3. 编写实现代码\n4. 运行 `tdd_runner.py green` �?确认测试通过（绿�?✓）\n5. 重构代码，保持绿�?\n### 运行时异常上下文注入（v10.6 新增�?\n**脚本**：`scripts/run_with_context.py`\n\n**功能**：运行脚本，捕获异常时收集局部变量快�?+ traceback + 修复建议\n\n**用法**�?```bash\n# 运行脚本，异常时输出完整上下�?python scripts/run_with_context.py src/main.py\n\n# 带参�?python scripts/run_with_context.py src/main.py --arg1 val1\n```\n\n**输出内容**�?- 异常类型和消�?- 异常位置（文�?行号:源代码）\n- 调用�?- 异常点局部变量快照（类型、值、长度等�?- 异常链（cause/context�?- 修复建议提示\n\n**强制规则**�?- 代码运行失败时，使用 `run_with_context.py` 替代直接运行\n- 根据输出的局部变量和修复建议定位根因\n- 修复后重新运行验�?\n### 性能基准对比（v10.8 新增�?\n**脚本**：`scripts/benchmark_runner.py`\n\n**功能**：对性能敏感函数生成 2+ 种实现方案，自动跑分对比，选择最优�?\n**用法**�?```bash\n# �?JSON 配置文件运行\npython scripts/benchmark_runner.py run config.json\n\n# JSON 输出\npython scripts/benchmark_runner.py run config.json --format json\n\n# 覆盖超时\npython scripts/benchmark_runner.py run config.json --timeout 60\n```\n\n**JSON 配置格式**�?```json\n{\n \"name\": \"list_dedup\",\n \"setup\": \"import random; data = [random.randint(0, 100) for _ in range(10000)]\",\n \"snippets\": [\n {\"name\": \"dict_from_keys\", \"code\": \"list(dict.fromkeys(data))\"},\n {\"name\": \"seen_set\", \"code\": \"seen = set(); [x for x in data if x not in seen and not seen.add(x)]\"}\n ],\n \"iterations\": 1000,\n \"warmup\": 10,\n \"validate\": \"assert sorted(r1) == sorted(r2)\",\n \"edge_cases\": [\n {\"name\": \"empty\", \"setup\": \"data = []\"},\n {\"name\": \"single\", \"setup\": \"data = [42]\"}\n ],\n \"timeout_per_snippet\": 30\n}\n```\n\n**性能指标**�?- **中位�?*（主决策指标，天然抗异常值）\n- **P95**（尾部延迟）\n- **标准�?*（稳定性判断）\n- **内存峰�?*（tracemalloc 估算值）\n\n**三级正确性验�?*�?- V1: 默认 `==` 比较\n- V2: 自定�?`validate` 表达式（`r1`, `r2` 代表两个方案输出�?- V3: 边界用例 `edge_cases`（空输入、单元素、极端值）\n\n**触发条件**�?- **AUTO_TRIGGER**: layered_validate L3 测试中执行时�?> 1s\n- **SUGGEST**: 用户明确要求性能优化 / 循环 > 1000 �?/ 处理大数据集\n\n**强制规则**�?- 性能敏感函数必须生成至少 2 种实�?- 所有方案必须通过正确性验证（含边界用例）\n- 选择中位数最快的方案，除非有明确理由选择其他\n- 输出 benchmark 报告供用户确�?\n**错误处理**�?- `SYNTAX_ERROR`: 代码语法错误，跳过该方案\n- `TIMEOUT`: 执行超时�?timeout_per_snippet），跳过\n- `OOM`: 内存溢出，跳�?- `VALIDATE_ERROR`: 验证函数本身报错，提示用户检�?\n**局限�?*�?- tracemalloc 无法跟踪子进程内存，多线程场景统计可能偏�?- v10.8 仅支�?Python，JS/TS 为实验�?- 不提供统计显著性检验（如需精确统计建议使用 pytest-benchmark�?\n### 依赖影响分析（v10.8 新增�?\n**脚本**：`scripts/analyze_impact.py`\n\n**功能**：修改模块后，自动分析影响范围，只跑相关测试以加速验证�?\n**用法**�?```bash\n# 分析单个文件\npython scripts/analyze_impact.py src/utils.py\n\n# 限制 BFS 深度（仅直接依赖�?python scripts/analyze_impact.py src/utils.py --depth 1\n\n# 分析 git diff（自动获取修改文件）\npython scripts/analyze_impact.py --git-diff\n\n# 分析并直接运行测�?python scripts/analyze_impact.py --git-diff --run-tests\n\n# JSON 输出\npython scripts/analyze_impact.py src/utils.py --format json\n\n# 指定项目根目�?python scripts/analyze_impact.py src/utils.py --root /path/to/project\n\n# 依赖提取级别（L1=AST, L2=+正则, L3=+文件名）\npython scripts/analyze_impact.py src/utils.py --level L2\n```\n\n**核心原理**�?- AST 解析 import 构建有向依赖�?- �?*反向依赖�?*�?BFS（谁依赖�?= 修改后会影响谁）\n- 三级测试映射确定受影响测�?\n**三级测试映射**�?| 级别 | 策略 | 示例 |\n|------|------|------|\n| M1 精确匹配 | `src/foo/bar.py` �?`tests/**/test_bar.py` | src/utils/parser.py �?tests/test_parser.py |\n| M2 目录匹配 | `src/foo/` �?`tests/foo/` | src/utils/ �?tests/utils/ |\n| M3 反向依赖 | test_a.py import �?src/utils.py �?受影�?| tests/test_api.py imports utils |\n| 兜底 | 找不到对应测�?�?提示全量运行 | �?|\n\n**触发条件**�?- 修改了共享模块（utils、config、types 等）�?自动触发\n- 不确定修改是否影响其他模�?�?建议触发\n\n**�?layered_validate 集成**�?- L3 发现修改文件后，自动调用 analyze_impact 给出建议\n- **实际执行由用户确�?*（避免虚假安全感�?\n**强制规则**�?- 修改共享模块后，必须运行 `analyze_impact.py` 确定影响范围\n- 只运行受影响的测试，不跑全量测试\n- 影响范围超过 10 个测试文件时，先跑直接依赖，再跑间接依赖\n- 使用 `--git-diff` 可自动分析当前未提交的修�?\n**大项目优�?*�?- 依赖图缓存到 `.impact_cache.json`（文件修改时间戳校验，增量更新）\n- `--depth N` 控制 BFS 深度（默认全图，不静默截断）\n- >1000 文件时显示警告，让用户确认是否限制深�?\n### 差异对比自审\n\n**触发条件**：修改现有文件后\n\n**强制流程**�?1. 使用 `git diff` 查看变更\n2. 自我审视变更合理性：\n - 是否引入了不必要的更改？\n - 是否可能破坏现有功能�? - 是否符合项目风格�?3. 发现问题 �?修正后再输出\n\n**示例**�?```bash\ngit diff src/main.py\n```\n\n**审视清单**�?- [ ] 变更是否最小化（只改必要的）？\n- [ ] 是否保留了原有功能？\n- [ ] 是否遵循项目编码规范�?- [ ] 是否有遗漏的边界情况�?\n## 代理系统\n\n7 个专业代理，按需选择�?\n| 代理 | 职责 | 触发场景 |\n|------|------|----------|\n| code-reviewer | 代码质量 + YAGNI 检�?| \"审查代码\"�?review\" |\n| security-auditor | 漏洞 + 凭证 + CWE | \"安全检�?�?漏洞\" |\n| test-engineer | 覆盖�?+ 用例生成 | \"写测�?�?覆盖�? |\n| architecture-critic | 模块 + 依赖 + 扩展�?| \"架构审查\"�?模块设计\" |\n| performance-analyst | 复杂�?+ 资源 + 并发 | \"性能审查\"�?瓶颈\" |\n| maintainability-reviewer | 命名 + 复杂�?+ 债务 | \"可维护�?�?技术债务\" |\n| documentation-checker | API 文档 + 注释 | \"文档检�?�?注释\" |\n\n### 代理职责矩阵（v10.1 新增�?\n避免重复审查，各代理独占检查项�?\n| 检查项 | 主责代理 | 协助代理 |\n|--------|----------|----------|\n| 代码风格/命名 | code-reviewer | maintainability-reviewer |\n| 逻辑正确�?| code-reviewer | - |\n| 安全漏洞/CWE | security-auditor | - |\n| 硬编码凭�?| security-auditor | code-reviewer |\n| 测试覆盖�?| test-engineer | - |\n| 模块耦合�?| architecture-critic | maintainability-reviewer |\n| 算法复杂�?| performance-analyst | - |\n| 技术债务评估 | maintainability-reviewer | architecture-critic |\n| API 文档完整�?| documentation-checker | - |\n\n**分层过滤**（v10.1 改进）：\n- 先快速扫描安�?critical 问题\n- 若发�?�?立即中断并通知用户，不必等其他代理完成\n- 若无 �?继续完整审查流程\n\n详细代理定义：`read agents/*.yaml`\n\n### 语言专属审查（v10.3 新增�?\n审查代码时，系统会根据文件扩展名自动选择语言专属 reviewer�?\n| 扩展�?| 专属 Reviewer | 审查重点 |\n|--------|---------------|----------|\n| .py | python-reviewer | PEP 8、类型注解、Pythonic 惯用法、安�?|\n| .ts/.tsx/.js/.jsx | typescript-reviewer | 类型安全、React 最佳实践、异步处�?|\n| .go | go-reviewer | goroutine、channel、错误处�?|\n| .rs | rust-reviewer | 所有权、生命周期、unsafe |\n\n**语言路由规则**�?- `review-orchestrator.py --auto-select` 自动检测文件扩展名\n- 语言专属 reviewer 与通用 code-reviewer 并行工作\n- 审查报告合并输出，按文件+行号归组\n\n**示例**�?```bash\n# 审查 Python 代码，自动选择 python-reviewer + code-reviewer\npython scripts/review-orchestrator.py \\\n --files \"src/main.py\" \\\n --auto-select\n```\n\n## 🔍 自动代码审查集成（v11.2 新增�?\n> 借鉴 Anthropic 官方 Code Review Plugin 设计，编码完成后自动触发多代理并行审查�?\n### 集成架构\n\n```\ncoding-framework（编码）\n �? ├─ 步骤1-5: 编码 + 验证 + 自审\n �? └─ 步骤6: 自动调用 code-review skill\n �? ├─ trivial/small �?跳过（🦆自审已覆盖�? ├─ medium �?快速审查（1代理，Bug Hunter视角�? ├─ large �?标准审查�?代理并行：Bug + Security + Maintainability�? └─ 关键模块 �?深度审查�?代理并行�? History + Spec Compliance�? �? ├─ 发现 high/critical �?修复 �?重新审查\n └─ 无高置信度问�?�?输出代码\n```\n\n### �?code-review skill 的关�?\n| 场景 | 触发方式 | 审查深度 |\n|------|---------|---------|\n| 写完代码后自动审�?| coding-framework 模式1步骤6自动触发 | 按复杂度分层 |\n| 用户主动要求审查 | 用户�?审查代码\" �?直接调用 code-review skill | 用户指定或默认标�?|\n| 完整开发流程中的审�?| coding-framework 模式5审查阶段自动触发 | 按任务复杂度 |\n| DAG 任务中的审查 | DAG review 阶段自动触发 | 按任务复杂度 |\n\n### 调用方式\n\n```\n# 自动触发（无需用户干预�?代码编写完成 �?验证通过 �?自动 read skills/code-review/SKILL.md �?按流程执�?\n# 手动触发\n用户�?审查这段代码\" �?直接 read skills/code-review/SKILL.md �?按流程执�?\n# 跳过审查\n用户�?不需要审�? / --skip-review �?跳过步骤6\n```\n\n### 审查深度选择逻辑\n\n```python\ndef select_review_depth(task_complexity, is_critical_module):\n if task_complexity in ('trivial', 'small'):\n return None # 跳过，🦆自审已覆盖\n elif task_complexity == 'medium':\n return 'quick' # 快速审查，1代理�?0�? elif task_complexity == 'large':\n if is_critical_module:\n return 'deep' # 深度审查�?代理�?-5分钟\n else:\n return 'standard' # 标准审查�?代理�?-2分钟\n```\n\n### 关键模块识别\n\n以下情况视为\"关键模块\"，自动升级为深度审查�?- 涉及认证/授权/加密\n- 涉及数据库操作（CRUD核心逻辑�?- 涉及外部API调用\n- 涉及并发/多线�?- 修改共享模块（utils、config、types�?- 安全敏感（处理用户输入、文件操作）\n\n## 迭代循环\n\n3 种模式：\n\n| 模式 | 说明 | 适用场景 |\n|------|------|----------|\n| fixed | 固定次数 | 已知需�?N �?|\n| max | 最大次�?+ 完成条件 | 有明确完成标�?|\n| adaptive | 根据改进幅度动态调�?| 不确定需要多少轮 |\n\n### 自适应模式度量标准（v10.1 新增�?\n**强制要求**：使�?adaptive 模式时，必须设置至少一个可度量指标�?- 响应时间（p50/p95/p99�?- 内存峰�?- 代码行数减少比例\n- 测试通过�?- 自定义指标（通过 regex 提取�?\n**度量方式**�?```bash\npython scripts/loop-controller.py init \\\n --name \"性能优化\" \\\n --mode adaptive \\\n --metric \"response_time_p95\" \\\n --threshold \"0.1\" # 改进幅度 < 10% 时停�?```\n\n**回退规则**：若用户未提供可度量指标，自动回退�?max 模式并提示�?\n### 完成条件类型\n\n| 类型 | 说明 | 示例 |\n|------|------|------|\n| regex | 正则匹配输出 | `--condition \"regex:All tests passed\"` |\n| file | 文件存在 | `--condition \"file:output/result.json\"` |\n| file-changed | 文件内容变化 | `--condition \"file-changed:src/main.py\"` |\n| llm | LLM 判断（v10.1 规范�?| 封闭性问�?+ JSON 布尔值返�?|\n\n**LLM 完成条件规范**（v10.1 新增）：\n- 必须基于封闭性问题（�?代码是否通过所有测试？\"�?- 返回格式：`{\"complete\": true/false, \"reason\": \"...\"}`\n- 禁止开放式问题（如\"代码是否足够好？\"�?\n控制器：`python scripts/loop-controller.py init --name \"task\" --mode max --max 10`\n\n### 反事实解释修复法（v10.6 新增�?\n**触发条件**：同一错误连续修复失败 2 �?\n**强制流程**�?1. 停止自动修复\n2. 输出自然语言解释�? ```\n 我认为之前的修复无效是因为：\n - �?1 次修复尝试：[描述] - 失败原因：[分析]\n - �?2 次修复尝试：[描述] - 失败原因：[分析]\n - 根本原因可能是：[推断]\n ```\n3. 基于该解释生成新的修复方�?4. 验证新方�?\n**目的**：避免盲目试错，强制模型理解错误根因后再修复�?\n**示例**�?```\n错误：IndexError: list index out of range\n\n�?1 次尝试：添加边界检�?if i < len(lst)\n失败原因：检查位置错误，在访问后才检�?\n�?2 尝试：在访问前添�?try-except\n失败原因：异常被吞掉，未处理根本问题\n\n根本原因：列表为空时不应进入循环，需检查列表是否为�?```\n\n### De-Sloppify 清理轮次（v10.3 新增�?\nLLM 编码常产�?冗余代码\"（测试语言特性、过度防御、console.log 等）�?De-Sloppify 模式在实现轮次之间插入清理轮次，保持代码简洁�?\n**执行顺序**（interval=2 为例）：\n```\niter 1: 实现功能\niter 2: 实现功能\niter 3: 清理轮次（de-sloppify�?iter 4: 实现功能\niter 5: 实现功能\niter 6: 清理轮次\n...\n```\n\n**使用方法**�?```bash\n# 启用 De-Sloppify\npython scripts/loop-controller.py init \\\n --name \"功能开�? \\\n --mode max --max 9 \\\n --sloppify \\\n --sloppify-interval 2\n```\n\n**清理轮次聚焦**�?- 删除类型系统已保证的冗余运行时检�?- 删除过度防御性的错误处理\n- 删除 console.log / 注释掉的代码\n- 删除未使用的导入和变�?- 简化冗余的条件判断\n\n**check 命令输出**�?```json\n{\n \"action\": \"check\",\n \"should_continue\": true,\n \"iteration\": 2,\n \"is_sloppify_round\": true,\n \"sloppify_focus\": [\n \"删除未使用的导入和变�?,\n \"删除 console.log / 注释掉的代码\",\n ...\n ]\n}\n```\n\n## 审查编排\n\n多代理并行审查使用编排脚本：\n\n```bash\n# 基本用法\npython scripts/review-orchestrator.py \\\n --files \"src/main.py\" \\\n --agents \"code-reviewer,security-auditor\"\n\n# 自动选择代理 + JSON 输出（v10.1�?python scripts/review-orchestrator.py \\\n --files \"src/main.py\" \\\n --auto-select \\\n --output json\n\n# 分层过滤：先扫描安全 critical（v10.1�?python scripts/review-orchestrator.py \\\n --files \"src/\" \\\n --fast-fail # 发现 critical 立即中断\n```\n\n**输出格式**（v10.1 改进）：\n- 默认：人类可读的 Markdown 报告\n- `--output json`：结构化 JSON，便于自动化集成\n\n## Hook 系统\n\n事件类型�?\n| 事件 | 触发时机 |\n|------|----------|\n| PreExec | exec 命令执行�?|\n| PostExec | exec 命令执行�?|\n| Stop | 会话结束前（迭代循环用） |\n\nHook 脚本位于 `hooks/` 目录，从 stdin 读取 JSON 事件数据，输�?JSON 决策�?\n## 渐进式披�?\n核心指令�?SKILL.md（本文件），详细参考按需加载�?\n- Hook 系统详情 �?`references/hook-system.md`\n- 代理系统详情 �?`references/agent-system.md`\n- 迭代模式详情 �?`references/iteration-patterns.md`\n- 安全模式详情 �?`references/security-patterns-detail.md`\n- 工作流示�?�?`references/workflow-examples.md`\n- **外部代理委派** �?`references/external-agents.md`（Codex/Claude Code/Git Worktree 并行�?\n## 文件结构\n\n```\ncoding-framework/\n├── SKILL.md # 本文件（编排器）\n├── .coding-framework.yml # 配置文件（v10.1 新增�?├── CONTRIBUTING.md # 扩展指南（v10.1 新增�?├── agents/ # 8 个子代理定义（v10.9 新增 explore�?�? ├── code-reviewer.yaml\n�? ├── security-auditor.yaml\n�? ├── test-engineer.yaml\n�? ├── architecture-critic.yaml\n�? ├── performance-analyst.yaml\n�? ├── maintainability-reviewer.yaml\n�? ├── documentation-checker.yaml\n�? └── explore.yaml # 侦察代理（v10.9 新增�?├── hooks/ # 3 个钩子脚�?�? ├── pre-exec-check.sh\n�? ├── post-exec-log.sh\n�? └── stop-iteration.sh\n├── rules/ # 4 个规则文�?�? ├── security-rules.md\n�? ├── security-patterns.md\n�? ├── coding-standards.md\n�? └── review-checklist.md\n├── scripts/ # 9 个工具脚�?�? ├── loop-controller.py\n�? ├── review-orchestrator.py\n�? ├── check-environment.py # 环境检查（v10.2 新增�?�? ├── static_analysis.py # 静态分析（v10.7 新增�?�? ├── layered_validate.py # 分层验证栈（v10.7 新增�?�? ├── tdd_runner.py # TDD 流程（v10.7 新增�?�? ├── run_with_context.py # 异常上下文注入（v10.7 新增�?�? ├── benchmark_runner.py # 性能基准对比（v10.8 新增�?�? ├── analyze_impact.py # 依赖影响分析（v10.8 新增�?�? └── worktree-manager.py # Git Worktree 管理（v11.0 新增�?├── plans/ # Plan Mode 计划文件（v10.9 新增�?�? └── README.md\n└── references/ # 6 个参考文�? ├── hook-system.md\n ├── agent-system.md\n ├── iteration-patterns.md\n ├── security-patterns-detail.md\n ├── workflow-examples.md\n ├── external-agents.md\n └── worktree-guide.md # Git Worktree 使用指南（v11.0 新增�?```\n\n## 配置（v10.1 新增�?\n通过 `.coding-framework.yml` 自定义行为：\n\n```yaml\n# 安全规则\nsecurity:\n enabled: true\n fast_fail: true # 发现 critical 立即中断\n\n# 代理配置\nagents:\n default_model: sonnet\n confidence_thresholds:\n critical: 50\n high: 70\n medium: 80\n low: 90\n\n# 迭代循环\niteration:\n default_mode: max\n heartbeat_timeout: 300 # �?\n# 日志\nlogging:\n level: info # debug/info/warn/error\n format: jsonl\n path: .coding-framework/logs/\n```\n\n## 扩展机制（v10.1 新增�?\n**新增代理**�?1. �?`agents/` 下创�?`your-agent.yaml`\n2. �?`.coding-framework.yml` 中注�?3. 详见 `CONTRIBUTING.md`\n\n**新增安全模式**�?1. �?`rules/security-patterns.md` 中添加模式定�?2. �?`rules/security-rules.md` 中添加匹配规�?3. pre-exec-check.sh 自动加载\n\n**新增迭代模式**�?1. �?`scripts/loop-controller.py` 中添加模式处理逻辑\n2. 更新 `references/iteration-patterns.md`\n\n## 文档加载决策表（v10.2 新增�?\n根据用户输入关键词自动预加载对应参考文档：\n\n| 关键�?| 预加载文�?| 说明 |\n|--------|------------|------|\n| 安全、漏洞、hook、pre-exec | `references/security-patterns-detail.md` | 安全模式详情 |\n| 代理、审查、review、agent | `references/agent-system.md` | 代理系统说明 |\n| 迭代、循环、loop、iterate | `references/iteration-patterns.md` | 迭代模式说明 |\n| Codex、Claude Code、worktree | `references/external-agents.md` | 外部代理委派 |\n| 示例、workflow、怎么�?| `references/workflow-examples.md` | 工作流示�?|\n| hook 事件、stdin、JSON | `references/hook-system.md` | Hook 系统说明 |\n\n**加载规则**�?- 匹配到关键词时，自动 `read` 对应文档的前 100 行作为上下文\n- 多个关键词匹配时，按优先级加载（安全 > 代理 > 迭代 > 外部 > 示例 > hook�?- 最多预加载 2 个文档，避免 token 浪费\n\n## 依赖与环境要求（v10.2 新增�?\n### 必需依赖\n\n| 依赖 | 版本 | 用�?| 安装方式 |\n|------|------|------|----------|\n| Python | 3.10+ | loop-controller.py, review-orchestrator.py | 系统包管理器 |\n| Git | 2.28+ | worktree 并行、版本控�?| 系统包管理器 |\n| bash | 4.0+ | hook 脚本执行 | Git Bash (Windows) / 系统自带 |\n\n### 可选依�?\n| 依赖 | 版本 | 用�?| 安装方式 |\n|------|------|------|----------|\n| jq | 1.6+ | hook 脚本 JSON 解析（推荐） | `scripts/install_jq_rg.ps1` |\n| Claude Code | latest | 外部代理委派 | `npm install -g @anthropic-ai/claude-code` |\n| Codex | latest | 外部代理委派 | `npm install -g @openai/codex` |\n\n### 支持平台\n\n| 平台 | 状�?| 备注 |\n|------|------|------|\n| macOS | �?完全支持 | 原生 bash |\n| Linux | �?完全支持 | 原生 bash |\n| Windows | �?支持 | 需安装 Git Bash |\n\n### 环境检查脚�?\n```bash\n# 检查必需依赖\npython scripts/check-environment.py\n\n# 输出示例:\n# �?Python 3.11.5\n# �?Git 2.42.0\n# �?bash 5.2.15\n# ⚠️ jq 未安装（hook 脚本将使�?bash fallback�?```\n\n## Git 集成与回滚（v10.2 新增�?\n迭代改进可能产生破坏性修改，loop-controller 集成 Git 自动回滚�?\n### 自动提交\n\n```bash\n# 初始化时启用自动提交\npython scripts/loop-controller.py init \\\n --name \"性能优化\" \\\n --mode max --max 10 \\\n --auto-commit\n\n# 每次迭代前自动创建临时提�?\n# git commit -m \"chore: pre-iteration snapshot (loop: 性能优化, iter: 3)\"\n```\n\n### 回滚\n\n```bash\n# 回滚到指定迭�?python scripts/loop-controller.py rollback --name \"性能优化\" --to 2\n\n# 回滚到上一次迭�?python scripts/loop-controller.py rollback --name \"性能优化\" --prev\n\n# 回滚到循环开始前\npython scripts/loop-controller.py rollback --name \"性能优化\" --initial\n```\n\n### 回滚机制\n\n1. 每次迭代前创�?Git tag: `loop/{name}/iter/{n}`\n2. 回滚�?`git checkout` 到对�?tag\n3. 保留所有迭代历史，可随时恢�?\n## 本能学习系统（v10.4 新增�?\n从编码实践中学习模式/规则，自动积累编码本能。脚本：`scripts/instinct-manager.py`。支持记录、查询、衰减、晋升。按项目隔离存储�?\n## 工作流编排（v10.4 新增�?\n支持完整的开发生命周期编排：分类 �?规划 �?执行 �?审查 �?优化�?\n### 模式 5：工作流编排（v11.0 增强�?\n触发：用户要求完整开发一个功�?/ \"develop\" / \"实现这个功能\"\n\n流程�?1. **任务分类** �?frontend / backend / fullstack\n2. **规划阶段** �?上下文检�?+ 实现计划（只读）\n3. **用户确认计划**\n4. **🌳 创建隔离工作�?*（v11.0 新增）：\n ```bash\n python scripts/worktree-manager.py create --name \"{task-name}\" --base master\n ```\n - �?`.worktrees/{task-name}/` 创建隔离工作�? - 自动创建同名分支\n - 后续步骤�?worktree 中执行，主分支保持干净\n - ⚠️ 如果任务简单（< 3 文件修改），可跳�?worktree\n5. **执行阶段** �?�?worktree 中按计划修改代码\n6. **🔍 审查阶段**（v11.2 增强）→ 自动调用 `code-review` skill�? - 根据任务复杂度选择审查深度�? - medium �?**快速审�?*�?代理�? - large �?**标准审查**�?代理并行�? - 关键模块/安全敏感 �?**深度审查**�?代理并行�? - 审查发现 �?修复后进入优化阶�? - 调用方式：`read skills/code-review/SKILL.md` �?按其流程执行\n7. **优化阶段** �?根据审查结果修复\n8. **交付确认** �?用户选择�? - **合并**：`git merge {branch}` �?`worktree-manager.py cleanup --merged`\n - **保留**：保�?worktree 继续开�? - **丢弃**：`git worktree remove .worktrees/{name}` + `git branch -D {branch}`\n\n**Worktree 管理命令**�?```bash\n# 创建隔离工作�?python scripts/worktree-manager.py create --name \"feature-x\"\n\n# 列出所�?worktree\npython scripts/worktree-manager.py list\n\n# 查看 worktree 状�?python scripts/worktree-manager.py status --name \"feature-x\"\n\n# 清理已合并的 worktree\npython scripts/worktree-manager.py cleanup --merged\n\n# 切换�?worktree 目录\npython scripts/worktree-manager.py switch --name \"feature-x\"\n```\n\n**执行完后输出上下文摘�?*（v10.9 新增）：\n```\n[Workflow] 开发完�?�?📚 上下�? 145k/203k (71%) | 🧮 本次: +25.3k tokens\n```\n调用 session_status 工具提取关键信息，输出一行简洁摘要�?\n### 模式 6：Plan Mode（结构化计划）（v10.9 新增�?\n> 借鉴 Copilot CLI �?Plan Mode：先做结构化计划（输出带 checkbox �?plan.md），等用户确认后再执行，执行时逐条勾选�?\n**触发**�?- 用户�?先做个计�? / \"plan\" / \"规划一�? / \"做个方案\"\n- 在模�?-5中按 Shift+Tab（或�?切换到计划模�?�?- 复杂任务自动建议�?这个任务比较复杂，建议先做计划？\"\n\n**流程**�?\n```\n1. 分析需求（只读，不修改代码�? ├─ 读取相关文件\n ├─ 理解现有架构\n └─ 识别依赖关系\n\n2. 生成 plan.md（带 checkbox�? ├─ 任务分解为可执行步骤\n ├─ 每个步骤�?checkbox: - [ ]\n ├─ 标注依赖关系（步骤间的先后顺序）\n ├─ 估算每步耗时\n └─ 保存�?plans/plan-YYYYMMDD-HHMMSS.md\n\n3. 等待用户确认\n ├─ 用户�?执行\" / \"开�? / \"go\" �?进入执行阶段\n ├─ 用户修改计划 �?更新 plan.md\n └─ 用户�?取消\" �?终止\n\n4. 逐条执行 + 勾�? ├─ 完成一�?�?- [x]\n ├─ 遇到问题 �?记录原因，继续下一步或暂停\n └─ 全部完成 �?输出总结\n```\n\n**plan.md 格式规范**�?\n```markdown\n# Implementation Plan: {功能名称}\n\n## Overview\n{一句话描述目标}\n\n## Context\n- 相关文件: file1.py, file2.ts, ...\n- 依赖: �?/ moduleA, moduleB\n- 预计耗时: ~30 分钟\n\n## Tasks\n\n### Phase 1: 基础设施\n- [ ] 创建数据模型 `models/user.py` (~5min)\n- [ ] 编写数据库迁移脚�?(~3min)\n\n### Phase 2: 核心逻辑\n- [ ] 实现 API 端点 `api/auth.py` (~10min)\n - 依赖: Phase 1 完成\n- [ ] 编写单元测试 `tests/test_auth.py` (~8min)\n\n### Phase 3: 集成\n- [ ] 前端对接 `pages/Login.tsx` (~10min)\n - 依赖: Phase 2 API 完成\n- [ ] 端到端测�?(~5min)\n\n## Risks\n- 风险1: 第三�?API 可能不稳�?�?降级方案: mock\n- 风险2: ...\n\n## Notes\n- 备注1: ...\n```\n\n**执行阶段输出**�?\n```\n[Plan] 执行�?.. (3/6)\n�?创建数据模型 models/user.py\n�?编写数据库迁移脚�?�?实现 API 端点 api/auth.py\n�?编写单元测试 tests/test_auth.py �?当前\n�?前端对接 pages/Login.tsx\n�?端到端测�?\n进度: 50% | 已用�? 15min | 预计剩余: 15min\n```\n\n**与模�?的区�?*�?- 模式5：完整的\"开发→审查→优�?流水线，适用�?实现整个功能\"\n- 模式6：纯粹的\"计划→确认→执行\"，适用�?先理清思路再动�?，可独立使用\n\n**执行完后输出上下文摘�?*（v10.9 新增）：\n```\n[Plan] 执行完成 (6/6) �?📚 上下�? 125k/203k (62%) | 🧮 本次: +8.2k tokens\n```\n调用 session_status 工具提取关键信息，输出一行简洁摘要�?\n**文件结构**�?```\nplans/\n plan-20260703-103000.md # 计划文件\n plan-20260703-143000.md\n```\n\n#### PDD 规格驱动模式（v11.4 新增，方案B�?\n> 借鉴 ralph-orchestrator �?Plan-Driven Development：大型功能使�?.specs/ 目录结构，将需�?设计/实现计划分离为独立文档�?\n**触发条件**�?- 复杂�?= large �?critical\n- 用户�?做个详细设计\" / \"�?spec\" / \"PDD\"\n- 涉及多模块、多文件、多阶段的复杂功�?\n**流程**�?\n```\n1. 创建 Spec 目录\n python scripts/spec-init.py \"功能名称\"\n # 生成 .specs/feature-name/ 目录\n\n2. 填写需�?�?requirements.md\n ├─ 用户故事\n ├─ 验收标准（Given/When/Then�? ├─ 边界条件\n └─ 非功能需�?\n3. 技术设�?�?design.md\n ├─ 架构概览\n ├─ 数据模型\n ├─ API 设计\n ├─ 安全考虑\n └─ 备选方案对�?\n4. 实现计划 �?implementation-plan.md\n ├─ 分阶段任务清单（每步 �?30分钟�? ├─ DAG 依赖�? ├─ 每步的验证标�? └─ 风险评估\n\n5. 用户确认 �?逐阶段执�?+ Backpressure 门控\n```\n\n**Spec 目录结构**�?```\n.specs/\n feature-name/\n README.md # 索引（状�?链接�? requirements.md # What �?需�? design.md # How �?设计\n implementation-plan.md # Steps �?实现步骤\n context.md # Why �?背景约束（可选）\n```\n\n**脚手架命�?*�?```bash\n# 创建 spec（默认模板）\npython scripts/spec-init.py \"Add JWT authentication\"\n\n# 创建 spec（API 模板�?python scripts/spec-init.py \"User management API\" --template api\n\n# 创建 spec（简单模式，�?context.md�?python scripts/spec-init.py \"Fix login bug\" --simple\n\n# 列出所�?specs\npython scripts/spec-init.py --list\n```\n\n**与简�?Plan Mode 的选择**�?| 场景 | 选择 | 原因 |\n|------|------|------|\n| trivial/small 任务 | 简�?plan.md | 轻量，一步到�?|\n| medium 任务 | 简�?plan.md | 够用 |\n| large 任务 | PDD .specs/ | 需�?设计/计划分离，便于追�?|\n| critical 任务 | PDD .specs/ | 完整文档，团队可审查 |\n\n### 模式 7：Explore 侦察（v10.9 新增�?\n> 借鉴 Copilot CLI �?Explore 代理：在独立上下文中快速侦察代码库，返回结论摘要，不污染主会话�?\n**触发**�?- 用户�?这个文件有多�? / \"有多少个测试文件\" / \"这个函数被谁调用\"\n- 编码前需要了解项目结�?- 不确定某个模块的依赖关系\n- 快速验证假设（\"有没有循环依�?�?\n**�?code-reviewer 的区�?*�?| 维度 | code-reviewer | Explore |\n|------|---------------|---------|\n| 深度 | 深度审查，输出详细报�?| 快速侦察，输出结论摘要 |\n| 上下�?| 完整上下�?| 独立上下文，不污染主会话 |\n| 输出 | Markdown 报告 | 结构�?JSON |\n| 耗时 | 2-5 分钟 | 30-60 �?|\n| 类比 | 体检报告 | 体温计读�?|\n\n**执行方式**�?```\nsessions_spawn(\n task: \"你是 explore 侦察代理。快速回答以下问题，返回结论摘要�? \n 问题：{user_question}\n \n 输出格式（严�?JSON）：\n {\\\"question\\\": \\\"原始问题\\\", \\\"answer\\\": \\\"结论摘要\\\", \\\"details\\\": {...}, \\\"confidence\\\": \\\"high|medium|low\\\"}\n \n 规则�? - 只读，不修改任何文件\n - 返回具体数字、路径、名�? - 不输出完整文件内�? - 不做深度分析\",\n model: \"sonnet\",\n mode: \"run\",\n runTimeoutSeconds: 60,\n tools: [\"Read\", \"Grep\", \"Glob\", \"exec\"]\n)\n```\n\n**典型任务**�?- 文件大小/行数统计\n- 目录结构概览\n- 函数/类的调用关系\n- 依赖关系查询\n- 测试文件映射\n- 快速验证假�?\n**输出示例**�?```json\n{\n \"question\": \"src/utils.py 有多少行�?,\n \"answer\": \"src/utils.py �?342 �?,\n \"details\": {\"file\": \"src/utils.py\", \"lines\": 342},\n \"confidence\": \"high\"\n}\n```\n\n**Token 预算控制**�?- 只传入问题，不传入整个项�?- 输出限制 500 tokens\n- 超时 60 �?\n**执行完后输出上下文摘�?*（v10.9 新增）：\n```\n[Explore] 侦察完成\n📚 上下�? 122k/203k (60%) | 🧮 本次: +2.1k tokens\n```\n调用 session_status 工具提取关键信息，输出一行简洁摘要�?\n### Mode X: Debug（v12.2 新增，P0，Feedback Loop First�?\n> 来源：DeepSeek 评审 P0 方案 �?\"没有 red-capable 命令就不进入 Phase 2\"\n> 核心原则�?*调试的本质是构建反馈循环，而非猜测修复�?*\n\n#### 铁律\n\n```\nNO RED-CAPABLE COMMAND = NO PHASE 2\n```\n\n如果你无法输出一�?能变红的命令\"（即能证�?bug 存在的失败测�?脚本），你不允许进入修复阶段�?\n#### 6 阶段流程\n\n```\nPhase 1: Build Feedback Loop\n ├─ 目标：构建一个能复现 bug 的自动化命令\n ├─ 输出：一个可执行的命令（test/script/curl/harness�? ├─ 检查点：⚠�?必须输出\"能变红的命令\"才能进入 Phase 2\n └─ 强制门控�? ├─ 输出命令 �?运行 �?确认失败（red）→ 进入 Phase 2 �? ├─ 无法输出命令 �?继续尝试构建 �?最�?3 种方�? └─ 3 种方式均失败 �?报告用户，请求帮�?\nPhase 2: Reproduce + Minimise\n ├─ 目标：确�?bug 可复现，并最小化复现条件\n ├─ 运行 Phase 1 的命�?�?确认 red\n ├─ 逐步移除无关变量（输入数�?配置/环境�? └─ 输出：最小复现用�?+ 运行命令\n\nPhase 3: Hypothesise\n ├─ 目标：基于最小复现，提出 1-3 个根因假�? ├─ 每个假设必须可证伪（能设计实验验证）\n ├─ 按可能性排�? └─ 输出：假设列�?+ 验证方法\n\nPhase 4: Instrument\n ├─ 目标：在关键路径添加调试日志/断点\n ├─ 使用 Tagged Debug Logs（见下方规范�? ├─ 日志必须包含假设验证所需信息\n └─ 输出：插桩代�?+ 预期输出\n\nPhase 5: Fix + Regression\n ├─ 目标：修�?bug + 添加回归测试\n ├─ 基于 Phase 3 的假设验证结果修�? ├─ 运行 Phase 1 的命�?�?确认 green\n ├─ 添加回归测试（防止同�?bug 再次出现�? └─ 输出：修复代�?+ 回归测试 + 验证证据\n\nPhase 6: Cleanup\n ├─ 目标：清理调试代码，恢复代码整洁\n ├─ 删除所�?[DEBUG-*] 日志\n ├─ 删除临时 harness/fixture\n ├─ 运行完整测试套件确认无回�? └─ 输出：清理后的代�?+ 最终验证证�?```\n\n#### Phase 1 强制检查点\n\n```\n╔════════════════════════════════════════════════════════════╗\n�? Phase 1 检查点 �?必须满足以下条件才能进入 Phase 2 �?╠════════════════════════════════════════════════════════════╣\n�? �?�? 1. 已输出一个具体命令（不是\"应该运行XXX\"�? �?�? 2. 该命令能独立运行（无需人工干预�? �?�? 3. 该命令当前会失败（red�? �?�? 4. 失败原因�?bug 本身（不是环�?配置问题�? �?�? �?�? 输出格式�? �?�? ``` �?�? [Phase 1 Checkpoint] �?�? Command: <具体命令> �?�? Expected failure: <失败描述> �?�? Actual output: <实际输出> �?�? Status: RED �?�?进入 Phase 2 �?�? ``` �?�? �?�? 如果无法输出命令 �?不允许进�?Phase 2 �?╚════════════════════════════════════════════════════════════╝\n```\n\n#### 10 种反馈循环构建方式（�?OpenClaw 环境可用性排序）\n\n| 优先�?| 方式 | 适用场景 | 示例 |\n|--------|------|----------|------|\n| 1 | **Failing Test** | 有测试框架的项目 | `pytest tests/test_bug.py -v` / `npm test -- --grep \"bug\"` |\n| 2 | **Curl/HTTP Script** | API/服务�?bug | `curl -X POST localhost:3000/api/bug-endpoint -d '{}'` |\n| 3 | **CLI Invocation + Fixture** | CLI 工具 bug | `python cli.py process --input fixture.json` |\n| 4 | **Throwaway Harness** | 无测试框架的函数/模块 | 临时 Python/JS 脚本调用目标函数 |\n| 5 | **HITL Bash Script** | 需要人工验证的 UI/视觉 bug | `bash verify.sh`（最后手段，需人工确认�?|\n| 6 | **Log Grep Pattern** | 日志中可追踪的错�?| `grep \"ERROR_PATTERN\" app.log \\| wc -l` |\n| 7 | **Exit Code Check** | 进程崩溃/异常退�?| `python script.py; echo $?` |\n| 8 | **Diff Comparison** | 输出不一�?bug | `diff expected.txt actual.txt` |\n| 9 | **Timeout Detection** | 性能/死锁 bug | `timeout 5s python script.py; echo $?` |\n| 10 | **Memory/Resource Check** | 内存泄漏/资源耗尽 | `python -c \"import resource; ...\"` |\n\n**选择原则**�?- 优先使用编号小的方式（更可靠、更易自动化�?- 方式 1-4 �?agent 可独立运行的（满�?Tight Loop 条件�?- 方式 5 需要人工介入，只在无其他选择时使�?\n#### Tagged Debug Logs 规范\n\n所有调试日志使用唯一前缀，便于清理和追踪�?\n```\n格式：[DEBUG-<4位随机hex>] <消息>\n\n示例�?[DEBUG-a4f2] Entering function process_order() with input: {id: 123}\n[DEBUG-a4f2] Database query returned: 0 rows\n[DEBUG-a4f2] Hypothesis check: expected 1 row, got 0 �?CONFIRMED\n\n规则�?1. 每次调试会话使用同一�?tag（如 a4f2�?2. tag �?Phase 4（Instrument）开始时生成\n3. 所有调试日志必须带 tag\n4. Phase 6（Cleanup）时删除所有带 tag 的行\n```\n\n**清理命令**�?```bash\n# 查找所有调试日�?grep -r \"\\[DEBUG-a4f2\\]\" src/\n\n# 删除所有调试日志（sed�?sed -i '/\\[DEBUG-a4f2\\]/d' src/**/*.py\n```\n\n#### Tight Loop 四条�?\n反馈循环必须同时满足以下 4 个条件，否则需要调整：\n\n| 条件 | 说明 | 检查方�?|\n|------|------|----------|\n| **Red-capable** | 当前能失败（证明 bug 存在�?| 运行命令，确认非零退出码或失败输�?|\n| **确定�?* | 每次运行结果一致（�?flaky�?| 连续运行 3 次，结果相同 |\n| **快速（秒级�?* | 运行时间 < 10 �?| `time ` |\n| **Agent 可独立运�?* | 无需人工干预 | agent 能自动运行并解析输出 |\n\n**不满足时的处�?*�?\n| 不满足条�?| 处理方式 |\n|-----------|----------|\n| �?red-capable | 检查输入数�?环境配置，确保触�?bug 路径 |\n| 非确定�?| 固定随机种子/mock 外部依赖/隔离环境 |\n| 非快�?| 减少测试数据规模/mock 慢依�?只运行相关测�?|\n| 非独立运�?| 改用其他方式（从 HITL �?Throwaway Harness �?Test�?|\n\n#### 反模式警�?\n| 你的想法 | 现实 |\n|---------|------|\n| \"我直接看代码就知�?bug 在哪\" | 知道 �?证明。先构建反馈循环�?|\n| \"这个 bug 太明显了，不需要测�? | 明显�?bug 也可能修错地方。用命令验证�?|\n| \"先修了再�? | 修了没有验证 = 猜测。Phase 1 先�?|\n| \"构建测试太麻�? | 不构建测�?= 没有反馈循环 = 盲修�?|\n| \"用眼睛看日志就够�? | 眼睛不可靠。用 grep/命令自动化�?|\n\n#### 与其他模式的关系\n\n- **Mode 1（快速编码）**：Mode X �?Mode 1 步骤 3（验证失败）时自动触�?- **Mode 3（迭代改进）**：Mode X �?Phase 5 修复后可进入 Mode 3 优化\n- **systematic-debugging skill**：Mode X 是框架级入口，systematic-debugging 是详细流�?- **verification-before-completion**：Mode X Phase 5 的修复必须通过 verification 门控\n\n---\n\n### 模式 9：三角色切换（v12.1 新增，P2�?\n> 来源：Superpowers 的多角色审查设计\n> 核心思想�?*无需子代�?*，在同一会话中切�?Implementer/Reviewer/Fixer 三个角色，实现自我审查和修复�?\n#### 为什么需�?\n- 子代理有额外 token 开销和延�?- 简单任务的代码审查不需要独立上下文\n- 角色切换强制 AI 从不同视角审视代码，减少盲点\n\n#### 三个角色\n\n| 角色 | 职责 | 视角 | 输出 |\n|------|------|------|------|\n| **Implementer** | 编写代码 | \"如何实现需�? | 代码 + 实现说明 |\n| **Reviewer** | 审查代码 | \"这段代码有什么问�? | 问题列表 + 严重�?|\n| **Fixer** | 修复问题 | \"如何精准修复\" | 修复代码 + 验证结果 |\n\n#### 流程\n\n```\n角色 1: Implementer\n ├─ 按需求编写代�? ├─ 完成�?�?明确标记 \"[Implementer] 实现完成\"\n └─ 输出代码 + 实现说明\n �?角色 2: Reviewer（切换！�? ├─ 以审查者视角阅读代�? ├─ 检查维度：\n �? ├─ 正确性：是否实现需求？\n �? ├─ 安全性：有无安全漏洞�? �? ├─ 简洁性：有无过度工程�? �? ├─ 边界条件：是否处理边界？\n �? └─ 风格：是否符合项目规范？\n ├─ 输出问题列表（按严重度排序）\n └─ 明确标记 \"[Reviewer] 审查完成\"\n �? 有问题？\n ├─ �?�?完成 �? └─ �?�?进入 Fixer 角色\n �?角色 3: Fixer（切换！�? ├─ 逐个修复 Reviewer 发现的问�? ├─ 每个修复后验�? └─ 明确标记 \"[Fixer] 修复完成\"\n �? 回到 Reviewer 角色（再次切换！�? ├─ 验证修复是否有效\n └─ 无新问题 �?完成 �?```\n\n#### 角色切换标记\n\n每次角色切换时，输出明确标记�?\n```\n---\n🔄 角色切换: Implementer �?Reviewer\n---\n\n[Reviewer 视角]\n审查以下代码...\n```\n\n```\n---\n🔄 角色切换: Reviewer �?Fixer\n---\n\n[Fixer 视角]\n修复问题 1: ...\n```\n\n#### 触发条件\n\n- 用户�?自我审查\" / \"三角�? / \"self-review\"\n- 任务复杂�?= medium（不需�?spawn 子代理，但需要审查视角）\n- 模式 1 步骤 6 的轻量替代（trivial/small 任务用🦆自审，medium 用三角色，large 用子代理审查�?\n#### 与子代理审查的区�?\n| 维度 | 三角色模�?| 子代理审�?|\n|------|-----------|-----------|\n| 上下�?| 同一会话 | 独立上下�?|\n| Token 开销 | 低（无额外上下文�?| 高（每个子代理独立上下文�?|\n| 审查深度 | 中等 | 深度 |\n| 适用复杂�?| medium | large/critical |\n| 速度 | �?| �?|\n\n#### 强制规则\n\n- 角色切换�?*必须**输出明确标记（�?角色切换�?- Reviewer 角色**必须**输出问题列表（即使没有问题也要说\"无问�?�?- Fixer 角色**必须**验证每个修复\n- 禁止跳过 Reviewer 角色直接进入 Fixer\n\n### 任务分类路由\n\n| 任务类型 | 特征关键�?| 主责代理 | 协助代理 |\n|----------|------------|----------|----------|\n| frontend | component, UI, 页面, 组件, 样式 | typescript-reviewer | code-reviewer |\n| backend | API, database, 接口, 算法 | python-reviewer | security-auditor |\n| fullstack | 默认 | code-reviewer | ts-reviewer + py-reviewer |\n\n### 使用方法\n\n```bash\n# 分类任务\npython scripts/workflow-orchestrator.py classify \\\n --description \"实现用户登录页面\" \\\n --files \"src/pages/Login.tsx\"\n\n# 生成实现计划（只读）\npython scripts/workflow-orchestrator.py plan \\\n --description \"实现用户登录功能\" \\\n --files \"src/pages/Login.tsx,src/api/auth.py\"\n\n# 执行计划\npython scripts/workflow-orchestrator.py execute --plan \"plans/plan-xxx.json\"\n\n# 审查代码\npython scripts/workflow-orchestrator.py review \\\n --files \"src/pages/Login.tsx\" \\\n --auto-select\n\n# 完整流水�?python scripts/workflow-orchestrator.py pipeline \\\n --description \"实现用户登录功能\" \\\n --files \"src/\"\n```\n\n### 专属代理\n\n| 代理 | 审查重点 |\n|------|----------|\n| frontend-reviewer | UI/UX、组件设计、响应式布局、可访问性、动�?|\n| backend-reviewer | API 设计、数据库操作、算法、业务逻辑、安�?|\n\n### 规划与执行分�?\n- **规划阶段**：只读，不修改代码，生成实现计划\n- **执行阶段**：按计划修改代码\n- **好处**：避�?边想边做\"的质量问题，用户可先审核计划\n\n## DAG 任务调度（v10.5 新增�?\n将大需求分解为有依赖关系的任务 DAG（有向无环图），按拓扑排序和复杂度分层执行�?\n### 核心概念\n\n| 概念 | 说明 |\n|------|------|\n| WorkUnit | 一个独立的工作单元（任务） |\n| Dependency | 任务间的依赖关系（前置任务） |\n| Complexity | 复杂度等级（trivial/small/medium/large�?|\n| Stage | 执行阶段（plan/execute/review/optimize�?|\n\n### 复杂度分层与质量流水�?\n不同复杂度走不同深度的质量流水线�?\n| 复杂�?| 权重 | 质量流水�?| 审查深度 | 预计耗时 |\n|--------|------|------------|----------|----------|\n| trivial | 1 | execute | 无（路径A自审已覆盖） | 5 分钟 |\n| small | 2 | execute �?review | 路径A自审（提示词级） | 15 分钟 |\n| medium | 4 | plan �?execute �?🦆 �?🔍code-review(快�? | 路径B自审 + code-review快速审查（1代理�?| 30 分钟 |\n| large | 8 | plan �?execute �?🦆 �?🔍code-review(标准) �?optimize | 路径B自审 + code-review标准审查�?代理�?| 60 分钟 |\n\n**设计原则**�?- trivial/small 任务跳过规划阶段，直接执�?- small 任务依赖路径A�?自审\"（模�?步骤4），不额外spawn子代�?- **medium+ 任务自动触发路径B的rubber-duck**：execute完成后，daily-agent收尾检查自动spawn轻量审查子代�?- large 任务需要完整的规划-执行-审查-优化流水�?- 审查深度随复杂度递增，避免过度审查简单任�?\n**🦆 Rubber Duck 自动触发规则（v10.9 新增�?*�?\n```\nexecute 阶段完成\n �?daily-agent 收尾检�? ├─ 任务类型 = 编码�?�?�?�?跳过\n ├─ 复杂�?�?medium�?�?�?�?跳过（路径A自审已覆盖）\n ├─ 用户已显式要求审查？ �?�?�?跳过（避免重复）\n └─ 满足全部条件 �?自动 spawn rubber-duck 子代�? ├─ verdict: \"pass\" �?静默通过，继�?review 阶段\n └─ verdict: \"fail\" �?issues 注入主会话，修复后进�?review 阶段\n```\n\n**🔍 Code-Review \n\nFile v12.0.1:plans/README.md\n\n��# Plans Directory\n\nPlan files generated by Plan Mode (!j\u000f_6) are stored here.\n\nFormat: plan-YYYYMMDD-HHMMSS.md\n\nFile v12.0.1:_meta.json\n\n{\n \"ownerId\": \"kn73z7zhz92tv6skpnmpy5pdfh86j68x\",\n \"slug\": \"coding-framework\",\n \"version\": \"12.0.1\",\n \"publishedAt\": 1784248112011\n}\n\nFile v12.0.1:references/agent-system.md\n\n# 代理系统完整文档\n\n> coding-framework 的标准化编程代理定义和调度系统。\n\n## 概述\n\n代理系统提供 7 个专业代理，每个代理有明确的职责、工具权限和输出格式。\n灵感来源：Claude Code 代理定义 + Codex YAML 格式 + OpenAI Codex 安全沙箱。\n\n## 代理定义规范\n\n每个代理使用 YAML 文件定义，存放于 `agents/` 目录：\n\n```yaml\nname: agent-id # 唯一标识符\ndisplay_name: \"显示名称\" # 中文友好名称\ndescription: \"职责描述\" # 一句话说明\nmodel: sonnet # 推荐模型\ncolor: green # UI 显示颜色\ntools: # 允许使用的工具\n - Read\n - Grep\ntrigger_examples: # 触发示例\n - \"示例消息\"\nsystem_prompt: | # 系统提示\n 详细的系统提示文本...\n```\n\n## 代理列表\n\n### code-reviewer（代码审查员）\n\n- **职责**：代码质量、可维护性、最佳实践 + Ponytail 决策阶梯\n- **工具**：Read, Grep, Glob, exec\n- **输出**：审查报告 + 评分（代码质量/可维护性/最佳实践/精简度）\n- **特色**：集成 YAGNI 决策阶梯，识别过度抽象\n\n### security-auditor（安全审计员）\n\n- **职责**：安全漏洞、敏感信息、权限风险 + 25 种安全模式\n- **工具**：Read, Grep, Glob, exec\n- **输出**：安全报告 + CWE 编号 + 安全评分\n- **特色**：覆盖 25 种安全模式，从注入到依赖漏洞\n\n### test-engineer（测试工程师）\n\n- **职责**：测试用例生成、覆盖率分析、测试策略\n- **工具**：Read, Grep, Glob, exec\n- **输出**：测试用例列表 + 测试代码 + 覆盖率建议\n- **特色**：单元/集成/边界/异常全覆盖\n\n### architecture-critic（架构批评家）\n\n- **职责**：模块划分、依赖关系、设计模式、扩展性\n- **工具**：Read, Grep, Glob\n- **输出**：JSON 结构化发现 + 评分\n- **特色**：SRP/开闭原则/循环依赖检测\n\n### performance-analyst（性能分析师）\n\n- **职责**：算法复杂度、资源泄漏、I/O 性能、并发\n- **工具**：Read, Grep, Glob, exec\n- **输出**：JSON 结构化发现 + 复杂度标注\n- **特色**：N+1 检测、内存泄漏识别、可量化优化建议\n\n### maintainability-reviewer（可维护性审查员）\n\n- **职责**：命名质量、函数设计、复杂度、技术债务\n- **工具**：Read, Grep, Glob\n- **输出**：JSON 结构化发现 + 评分\n- **特色**：TODO/FIXME 检测、圈复杂度分析\n\n### documentation-checker（文档检查员）\n\n- **职责**：API 文档、代码注释、README 完整性\n- **工具**：Read, Grep, Glob\n- **输出**：JSON 结构化发现 + 评分\n- **特色**：文档一致性检查、示例代码建议\n\n## 调度逻辑\n\n```\n用户请求 → 识别任务类型\n → 关键词匹配（trigger_examples）\n → 文件类型匹配（扩展名）\n → 任务类型匹配（审查/安全/测试）\n → 默认回退：code-reviewer\n```\n\n调度优先级：security-auditor > test-engineer > code-reviewer\n\n## 与 sessions_spawn 集成\n\n```\n用户请求 → coding-framework 识别任务类型\n → 加载对应 agents/*.yaml\n → sessions_spawn(\n model: agent.model,\n system_prompt: agent.system_prompt,\n task: 用户请求 + 上下文\n )\n → 等待子代理返回\n → 格式化输出\n```\n\n## 输出格式规范\n\n所有代理输出遵循统一格式：\n\n```markdown\n## [代理名称] 审查结果\n\n### 概要\n一句话总结发现。\n\n### 详细发现\n1. **[严重程度]** 问题描述\n - 位置：文件:行号\n - 建议：修复方案\n\n### 评分\n- 整体评分：X/10\n- 置信度：X%\n```\n\n## 自定义代理\n\n在 `agents/` 下创建新的 `.yaml` 文件，确保：\n- `name` 唯一\n- `system_prompt` 足够详细\n- `trigger_examples` 覆盖常见场景\n- `tools` 最小权限原则\n\nFile v12.0.1:references/external-agents.md\n\n# 外部编码代理委派模式\n\n> 来源：coding-agent skill，适配 coding-framework\n> 版本：10.1.0（v10.1 新增安全警告和冲突处理）\n\n## 概述\n\n当任务需要外部编码代理（Codex / Claude Code / Pi）时，使用本指南。\n\n**核心原则**：coding-framework 负责质量治理，外部代理负责执行。\n\n---\n\n## 1. 代理选择\n\n| 代理 | 调用方式 | 适用场景 |\n|------|----------|----------|\n| Claude Code | `claude --print 'task'` | 复杂重构、代码生成 |\n| Codex | `bash pty:true command:\"codex exec --full-auto 'task'\"` | 快速修复、批量任务 |\n| Pi | `bash pty:true command:\"pi 'task'\"` | 轻量任务 |\n\n---\n\n## 2. 调用模式\n\n### Claude Code（非交互）\n\n```bash\n# 前台执行（推荐：使用权限白名单）\nbash workdir:~/project command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\n\n# 后台执行\nbash workdir:~/project background:true command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\n```\n\n> ⚠️ **安全警告（v10.1 新增）**：\n> \n> `--permission-mode bypassPermissions` 绕过所有权限检查，**仅适用于完全隔离的沙箱环境**（如 Docker 容器、临时 VM）。\n> \n> **不推荐在本地开发环境使用**。生产环境请使用 `--allowedTools` 白名单模式。\n\n### Codex（PTY 模式）\n\n```bash\n# 快速一次性任务\nbash pty:true workdir:~/project command:\"codex exec --full-auto 'Add error handling'\"\n\n# 后台长任务\nbash pty:true workdir:~/project background:true command:\"codex --yolo 'Refactor auth module'\"\n```\n\n**注意**：Codex 需要 Git 仓库环境，临时任务用 `mktemp -d && git init`。\n\n---\n\n## 3. Git Worktree 并行修复\n\n用于同时修复多个 Issue，每个 worktree 独立工作目录：\n\n```bash\n# 1. 创建 worktree\ngit worktree add -b fix/issue-78 /tmp/issue-78 main\ngit worktree add -b fix/issue-99 /tmp/issue-99 main\n\n# 2. 在每个 worktree 启动代理\nbash pty:true workdir:/tmp/issue-78 background:true command:\"codex --yolo 'Fix issue #78: . Commit and push.'\"\nbash pty:true workdir:/tmp/issue-99 background:true command:\"codex --yolo 'Fix issue #99. Commit and push.'\"\n\n# 3. 监控进度\nprocess action:list\nprocess action:log sessionId:XXX\n\n# 4. 创建 PR\ncd /tmp/issue-78 && git push -u origin fix/issue-78\ngh pr create --head fix/issue-78 --title \"fix: ...\" --body \"...\"\n\n# 5. 清理\ngit worktree remove /tmp/issue-78\n```\n\n### Worktree 冲突处理（v10.1 新增）\n\n**约束**：worktree 任务必须修改不相交的文件集。\n\n**冲突检测脚本**：\n\n```bash\n#!/bin/bash\n# check-worktree-conflict.sh\n# 检查多个 worktree 是否修改了相同文件\n\nWORKTREES=(\"$@\")\nCONFLICT_FILES=\"\"\n\nfor wt in \"${WORKTREES[@]}\"; do\n files=$(cd \"$wt\" && git diff --name-only HEAD 2>/dev/null)\n for f in $files; do\n if echo \"$CONFLICT_FILES\" | grep -q \"$f\"; then\n echo \"⚠️ 冲突文件: $f (在多个 worktree 中被修改)\"\n else\n CONFLICT_FILES=\"$CONFLICT_FILES $f\"\n fi\n done\ndone\n\nif [ -z \"$CONFLICT_FILES\" ]; then\n echo \"✅ 无文件冲突\"\nelse\n echo \"📋 已修改文件: $CONFLICT_FILES\"\nfi\n```\n\n**使用方式**：\n\n```bash\n# 启动 worktree 前检查\nbash check-worktree-conflict.sh /tmp/issue-78 /tmp/issue-99\n\n# 如果检测到冲突，调整任务分配\n```\n\n---\n\n## 4. 完成自动通知\n\n在任务 prompt 末尾追加通知命令：\n\n```bash\ncodex --yolo exec 'Build a REST API.\n\nWhen completely finished, run:\nopenclaw system event --text \"Done: Built REST API with CRUD endpoints\" --mode now'\n```\n\n效果：任务完成后立即触发 wake event，无需轮询。\n\n> **依赖说明**：`openclaw` 命令需要在 PATH 中可用。如果使用其他通知方式，可替换为 webhook 或 OS 通知。\n\n---\n\n## 5. 进度更新协议\n\n后台任务执行期间，按以下节奏更新用户：\n\n| 时机 | 内容 |\n|------|------|\n| 启动时 | 1 条消息：运行什么、在哪里 |\n| 里程碑完成 | 构建完成、测试通过等 |\n| 需要输入 | 代理提问、需要确认 |\n| 出错 | 错误信息、需要用户操作 |\n| 完成 | 结果摘要、变更位置 |\n\n---\n\n## 6. 安全约束\n\n- **不在 `~/.openclaw/` 启动外部代理**（会读取 soul docs）\n- **不在 OpenClaw 实例目录切换分支**\n- **PR 审查在临时目录或 worktree 进行**\n- **bypassPermissions 仅在隔离沙箱中使用**（v10.1）\n- **worktree 任务必须修改不相交文件集**（v10.1）\n\n---\n\n## 7. 与 coding-framework 集成\n\n```\n用户请求\n │\n ├─ 简单编码 → coding-framework 模式 1（快速编码）\n │\n ├─ 复杂编码 → coding-framework 模式 1 + 外部代理\n │ └─ 本指南的调用模式\n │\n ├─ 批量修复 → Git Worktree 并行 + 外部代理\n │ └─ 冲突检测 → 调整任务分配\n │\n └─ 代码审查 → coding-framework 模式 2（代理审查）\n```\n\n---\n\n## 8. 环境要求\n\n| 依赖 | 版本 | 说明 |\n|------|------|------|\n| Git | 2.28+ | worktree 支持 |\n| Claude Code | latest | `claude` 命令 |\n| Codex | latest | `codex` 命令 |\n| openclaw | latest | 通知命令（可选） |\n\n**支持平台**：\n- macOS\n- Linux\n- Windows (Git Bash)\n\nFile v12.0.1:references/hook-system.md\n\n# Hook 系统完整文档\n\n> coding-framework 的事件驱动行为守卫系统。\n\n## 概述\n\nHook 系统提供可配置的事件拦截与行为守卫，在关键执行节点插入检查和日志。\n灵感来源：Claude Code Hook 事件系统。\n\n## 事件类型\n\n| 事件 | 触发时机 | 输入数据 | 输出 |\n|------|----------|----------|------|\n| PreExec | exec 命令执行前 | `{command, workdir, env}` | `{decision, message, matched_rules}` |\n| PostExec | exec 命令执行后 | `{command, exitCode, stdout, stderr, duration}` | `{decision, message}` |\n| Stop | 会话结束前 | `{session, reason, summary}` | `{decision, should_stop, pending_tasks}` |\n\n## 规则引擎\n\n规则定义在 `rules/` 目录下，每个 `.md` 文件包含 YAML frontmatter：\n\n```yaml\n---\nname: rule-name\nenabled: true\nevent: PreExec\nmatcher: \"rm -rf\" # regex 匹配模式\naction: block # allow | warn | block | log\npriority: 10 # 数字越大优先级越高\n---\n```\n\n规则 body 部分定义详细说明、触发消息和豁免条件。\n\n## 动作类型\n\n| 动作 | 说明 |\n|------|------|\n| allow | 放行，记录日志 |\n| warn | 放行但输出警告信息 |\n| block | 阻止执行，返回拒绝原因 |\n| log | 仅记录，不影响流程 |\n\n## Hook 脚本规范\n\n所有 hook 脚本位于 `hooks/` 目录：\n\n1. 从 stdin 读取 JSON 事件数据\n2. 加载 `rules/` 下匹配的规则\n3. 按优先级逐条评估\n4. 输出 JSON 结果到 stdout\n\n```json\n{\n \"decision\": \"allow|warn|block\",\n \"message\": \"人类可读的说明\",\n \"matched_rules\": [\"rule-name-1\"],\n \"timestamp\": \"2026-06-26T22:00:00Z\"\n}\n```\n\n## 脚本说明\n\n### pre-exec-check.sh\n\n执行前安全检查。读取命令，匹配 security-rules.md 中的规则，输出决策。\n\n### post-exec-log.sh\n\n执行后日志记录。读取执行结果，写入审计日志 `memory/hook-audit.log`。\n\n### stop-iteration.sh\n\n迭代循环 Stop Hook。检查是否有活跃的迭代循环或待完成的承诺，未完成则阻止停止。\n\n## 与 daily-agent 集成\n\n```\n用户消息 → daily-agent 分类\n → 任务执行\n → [PreExec hook] 每次 exec 前检查\n → [PostExec hook] 每次 exec 后记录\n → [Stop hook] 会话结束清理\n```\n\n## 添加新规则\n\n在 `rules/` 下创建或编辑 `.md` 文件，按 YAML frontmatter 格式定义：\n\n```yaml\n---\nname: no-format-disk\nenabled: true\nevent: PreExec\nmatcher: \"format|diskpart|chkdsk\"\naction: block\npriority: 100\n---\n禁止执行磁盘格式化操作。此规则不可豁免。\n```\n\n## 审计日志\n\n所有 hook 触发记录写入 `memory/hook-audit.log`：\n\n```\n[timestamp] [event] [decision] [rule] message\n```\n\nFile v12.0.1:references/iteration-patterns.md\n\n# 迭代模式参考\n\n> coding-framework 的迭代循环机制详细说明。\n\n## 概述\n\n借鉴 Claude Code Ralph Wiggum 的 Stop Hook 自引用循环模式，通过状态文件 + 循环控制器实现可控的迭代执行。\n\n## 迭代模式\n\n### fixed（固定次数）\n\n执行指定次数后停止，不做完成条件判断。\n\n```bash\npython scripts/loop-controller.py init --mode fixed --max 5\n```\n\n适用场景：已知需要 N 轮迭代的任务。\n\n### max（最大次数 + 完成条件）\n\n最多执行 N 次，满足完成条件时提前退出。\n\n```bash\npython scripts/loop-controller.py init --mode max --max 10 --condition \"regex:BUILD SUCCESS\"\n```\n\n适用场景：有明确完成标准但不确定需要多少轮。\n\n### adaptive（自适应）\n\n根据每轮改进幅度动态决定是否继续。连续 N 轮无改进则停止。\n\n```bash\npython scripts/loop-controller.py init --mode adaptive --max 20 --patience 3\n```\n\n适用场景：不确定需要多少轮，希望自动收敛。\n\n## 完成条件类型\n\n| 类型 | 说明 | 示例 |\n|------|------|------|\n| regex | 在最后一轮 summary 中匹配正则 | `regex:All tests passed` |\n| file | 检查文件是否存在 | `file:output/result.txt` |\n| file-changed | 检查文件是否在最近一轮被修改 | `file-changed:src/main.py` |\n| llm | 由 LLM 评估（需外部处理） | `llm:代码质量达到可发布标准` |\n\n## 工作流\n\n### 1. 初始化循环\n\n```bash\npython scripts/loop-controller.py init \\\n --name \"refactor-module\" \\\n --mode max \\\n --max 10 \\\n --condition \"regex:All tests passed\"\n```\n\n### 2. 执行迭代\n\n每轮迭代的标准流程：\n\n```\n1. 检查状态 → loop-controller.py check\n2. 执行任务 → 运行实际工作\n3. 评估结果 → 检查完成条件\n4. 更新状态 → loop-controller.py update --result ...\n5. 如果完成 → loop-controller.py complete\n```\n\n### 3. 与 sessions_spawn 集成\n\n```\n主代理：初始化循环 → loop-controller.py init\n ↓\n循环开始：\n → sessions_spawn（子代理执行一轮迭代）\n → 子代理完成后报告结果\n → loop-controller.py update --result <结果>\n → loop-controller.py check（是否继续）\n ↓\n循环结束：loop-controller.py complete\n```\n\n## 状态文件格式\n\n```json\n{\n \"name\": \"任务名称\",\n \"mode\": \"fixed|max|adaptive\",\n \"max_iterations\": 10,\n \"current_iteration\": 3,\n \"completion_check\": {\n \"type\": \"regex|file|file-changed|llm\",\n \"pattern\": \"检测模式\"\n },\n \"patience\": 3,\n \"no_improvement_count\": 0,\n \"history\": [\n {\n \"iteration\": 1,\n \"timestamp\": \"2026-06-26T22:00:00\",\n \"result\": \"pass|fail|partial\",\n \"summary\": \"本轮做了什么\",\n \"metrics\": {}\n }\n ],\n \"artifacts\": [\"产出文件列表\"],\n \"status\": \"running|completed|failed|cancelled\",\n \"metadata\": {}\n}\n```\n\n## 命令参考\n\n| 命令 | 说明 | 关键参数 |\n|------|------|----------|\n| init | 初始化循环 | `--name --mode --max --condition --patience --state` |\n| check | 检查是否应继续 | `--state` |\n| update | 更新迭代结果 | `--state --result --summary --metrics --artifact` |\n| complete | 标记循环完成 | `--state --reason --status` |\n\n## Stop Hook 集成\n\n`hooks/stop-iteration.sh` 在会话结束前检查：\n- 是否有活跃的迭代循环（loop-state.json status=running）\n- 是否有待完成的承诺（.pending-promises）\n- 未完成则阻止停止，返回提示信息\n\n## 使用示例\n\n### 代码重构迭代\n\n```bash\npython scripts/loop-controller.py init --name \"refactor\" --mode max --max 5 --condition \"regex:coverage.*90%\"\npython scripts/loop-controller.py check --state loop-state.json\n# → 执行重构...\npython scripts/loop-controller.py update --state loop-state.json --result pass --summary \"提取了3个函数\"\npython scripts/loop-controller.py complete --state loop-state.json --reason \"覆盖率达到92%\"\n```\n\n### 测试修复迭代\n\n```bash\npython scripts/loop-controller.py init --name \"fix-tests\" --mode adaptive --max 15 --patience 3\n# 每轮：运行测试 → 修复失败 → 记录结果\n# 连续3轮无进展时自动停止\n```\n\nFile v12.0.1:references/security-patterns-detail.md\n\n# 安全模式详细说明\n\n> 25 种安全模式的完整说明，含检测逻辑、修复方案和真实案例。\n\n## 概述\n\n安全模式集成到 hook-engine 的 PreExec 钩子，用于命令执行前和代码审查时的安全检测。\n灵感来源：Claude Code security-guidance（~2000 行 Python，25 种安全模式）。\n\n## 严重级别处理策略\n\n| 级别 | 处理方式 | 示例 |\n|------|----------|------|\n| critical | 阻止执行 + 报告用户 + 记录日志 | SQL 注入、SSRF、提权 |\n| high | 阻止执行 + 请求确认 + 记录日志 | XSS、硬编码凭证、外部下载 |\n| medium | 允许执行 + 记录告警日志 | 不安全加密、资源泄漏、CORS |\n| low | 记录日志，不干预 | 代码风格安全建议 |\n\n## 模式分类\n\n### 系统安全（1-8）\n\n1. **危险命令** (critical) — rm -rf /, format, diskpart, mkfs\n2. **注册表操作** (critical) — reg add/delete, Set-ItemProperty HKLM\n3. **账户管理** (critical) — net user, useradd, Add-LocalGroupMember\n4. **服务管理** (high) — sc delete/config, systemctl, net start/stop\n5. **计划任务** (high) — schtasks, crontab, New-ScheduledTask\n6. **外部下载** (high) — curl/wget 到非白名单域名, certutil\n7. **批量操作** (high) — del /s /q, 管道接 Remove-Item\n8. **提权操作** (critical) — runas, sudo, su, pkexec\n\n### 数据安全（9-12）\n\n9. **敏感数据传输** (high) — scp .ssh/.env, curl -d password\n10. **代码执行风险** (high) — eval(拼接), exec(拼接), subprocess shell=True\n11. **敏感信息泄露** (high) — 硬编码 API key\n\nArchive v12.0.0: 41 files, 128974 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/backend-reviewer.yaml (2417b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/explore.yaml (1953b), agents/frontend-reviewer.yaml (2200b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/python-reviewer.yaml (1542b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), agents/typescript-reviewer.yaml (1663b), CONTRIBUTING.md (5347b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (5768b), plans/README.md (222b), references/agent-system.md (3873b), references/external-agents.md (5245b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/tdd-anti-patterns.md (5140b), references/workflow-examples.md (4292b), references/worktree-guide.md (4020b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/check-environment.py (9612b), scripts/dag-scheduler.py (20140b), scripts/instinct-manager.py (15687b), scripts/loop-controller.py (49784b), scripts/review-orchestrator.py (19367b), scripts/spec-init.py (9132b), scripts/tdd_runner.py (13193b), scripts/workflow-orchestrator.py (15221b), scripts/worktree-manager.py (10838b), skill-card.md (2812b), SKILL.md (77661b), _meta.json (136b)\n\nArchive v10.8.0: 34 files, 91284 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/backend-reviewer.yaml (2417b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/frontend-reviewer.yaml (2200b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/python-reviewer.yaml (1542b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), agents/typescript-reviewer.yaml (1663b), CONTRIBUTING.md (5347b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (5768b), references/agent-system.md (3873b), references/external-agents.md (5245b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/workflow-examples.md (4292b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/check-environment.py (9612b), scripts/dag-scheduler.py (20140b), scripts/instinct-manager.py (15687b), scripts/loop-controller.py (29849b), scripts/review-orchestrator.py (19367b), scripts/workflow-orchestrator.py (15221b), skill-card.md (2755b), SKILL.md (36344b), _meta.json (136b)\n\nArchive v10.5.0: 34 files, 87264 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/backend-reviewer.yaml (2417b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/frontend-reviewer.yaml (2200b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/python-reviewer.yaml (1542b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), agents/typescript-reviewer.yaml (1663b), CONTRIBUTING.md (5347b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (5768b), references/agent-system.md (3873b), references/external-agents.md (5245b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/workflow-examples.md (4292b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/check-environment.py (9612b), scripts/dag-scheduler.py (20140b), scripts/instinct-manager.py (15687b), scripts/loop-controller.py (29849b), scripts/review-orchestrator.py (19367b), scripts/workflow-orchestrator.py (15221b), skill-card.md (2789b), SKILL.md (25298b), _meta.json (136b)\n\nArchive v10.2.0: 27 files, 63746 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), CONTRIBUTING.md (5347b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (5768b), references/agent-system.md (3873b), references/external-agents.md (5245b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/workflow-examples.md (4292b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/check-environment.py (9612b), scripts/loop-controller.py (27376b), scripts/review-orchestrator.py (18786b), skill-card.md (2735b), SKILL.md (15897b), _meta.json (136b)\n\nArchive v10.0.0: 24 files, 46621 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (3755b), references/agent-system.md (3873b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/workflow-examples.md (4292b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/loop-controller.py (14346b), scripts/review-orchestrator.py (13591b), skill-card.md (2631b), SKILL.md (7005b), _meta.json (136b)\n\nArchive v3.0.3: 24 files, 46692 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (3755b), references/agent-system.md (3873b), references/hook-system.md (2671b), references/iteration-patterns.md (4122b), references/security-patterns-detail.md (4023b), references/workflow-examples.md (4292b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/loop-controller.py (14346b), scripts/review-orchestrator.py (13591b), skill-card.md (2888b), SKILL.md (7005b), _meta.json (135b)\n\nArchive v3.0.2: 24 files, 49614 bytes\n\nFiles: agents/architecture-critic.yaml (1833b), agents/code-reviewer.yaml (3321b), agents/documentation-checker.yaml (2082b), agents/maintainability-reviewer.yaml (2044b), agents/performance-analyst.yaml (2181b), agents/security-auditor.yaml (2623b), agents/test-engineer.yaml (2032b), hooks/post-exec-log.sh (1932b), hooks/pre-exec-check.sh (3449b), hooks/stop-iteration.sh (3755b), references/agent-system.md (5315b), references/hook-system.md (4118b), references/iteration-patterns.md (4831b), references/security-patterns-detail.md (4970b), references/workflow-examples.md (5575b), rules/coding-standards.md (2529b), rules/review-checklist.md (2209b), rules/security-patterns.md (10273b), rules/security-rules.md (1890b), scripts/loop-controller.py (14346b), scripts/review-orchestrator.py (13591b), skill-card.md (2937b), SKILL.md (7005b), _meta.json (135b)\n\nArchive v3.0.1: 24 files, 46619 bytes\n\nFiles: agents/architecture-critic.yaml (1998b), agents/code-reviewer.yaml (3361b), agents/documentation-checker.yaml (1799b), agents/maintainability-reviewer.yaml (1770b), agents/performance-analyst.yaml (2008b), agents/security-auditor.yaml (3299b), agents/test-engineer.yaml (2149b), hooks/post-exec-log.sh (1052b), hooks/pre-exec-check.sh (3364b), hooks/stop-iteration.sh (1659b), references/agent-system.md (3001b), references/hook-system.md (2769b), references/iteration-patterns.md (4341b), references/security-patterns-detail.md (6165b), references/workflow-examples.md (4982b), rules/coding-standards.md (3666b), rules/review-checklist.md (3993b), rules/security-patterns.md (9295b), rules/security-rules.md (1841b), scripts/loop-controller.py (9830b), scripts/review-orchestrator.py (11696b), skill-card.md (2734b), SKILL.md (7005b), _meta.json (135b)","readmeExcerpt":"Skill: coding-framework Owner: paudyyin Summary: Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Tags: latest:13.0.0 Version history: v13.0.0 | 2026-08-03T00:55:05.468Z | auto Version 13.0.0 (coding-framework) – Major update with new structure and advanced multi-skill orchestration - Refactored SKILL.md: now includes explicit skill path mapping and extended modular","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"File v13.0.0:references/iteration-patterns.md\n\n# 迭代模式参考\r\n\r\n> coding-framework 的迭代循环机制详细说明。\r\n\r\n## 概述\r\n\r\n借鉴 Claude Code Ralph Wiggum 的 Stop Hook 自引用循环模式，通过状态文件 + 循环控制器实现可控的迭代执行。\r\n\r\n## 迭代模式\r\n\r\n### fixed（固定次数）\r\n\r\n执行指定次数后停止，不做完成条件判断。"},{"language":"text","snippet":"File v13.0.0:references/security-patterns-detail.md\n\n# 安全模式详细说明\r\n\r\n> 25 种安全模式的完整说明，含检测逻辑、修复方案和真实案例。\r\n\r\n## 概述\r\n\r\n安全模式集成到 hook-engine 的 PreExec 钩子，用于命令执行前和代码审查时的安全检测。\r\n灵感来源：Claude Code security-guidance（~2000 行 Python，25 种安全模式）。\r\n\r\n## 严重级别处理策略\r\n\r\n| 级别 | 处理方式 | 示例 |\r\n|------|----------|------|\r\n| critical | 阻止执行 + 报告用户 + 记录日志 | SQL 注入、SSRF、提权 |\r\n| high | 阻止执行 + 请求确认 + 记录日志 | XSS、硬编码凭证、外部下载 |\r\n| medium | 允许执行 + 记录告警日志 | 不安全加密、资源泄漏、CORS |\r\n| low | 记录日志，不干预 | 代码风格安全建议 |\r\n\r\n## 模式分类\r\n\r\n### 系统安全（1-8）\r\n\r\n1. **危险命令** (critical) — rm -rf /, format, diskpart, mkfs\r\n2. **注册表操作** (critical) — reg add/delete, Set-ItemProperty HKLM\r\n3. **账户管理** (critical) — net user, useradd, Add-LocalGroupMember\r\n4. **服务管理** (high) — sc delete/config, systemctl, net start/stop\r\n5. **计划任务** (high) — schtasks, crontab, New-ScheduledTask\r\n6. **外部下载** (high) — curl/wget 到非白名单域名, certutil\r\n7. **批量操作** (high) — del /s /q, 管道接 Remove-Item\r\n8. **提权操作** (critical) — runas, sudo, su, pkexec\r\n\r\n### 数据安全（9-12）\r\n\r\n9. **敏感数据传输** (high) — scp .ssh/.env, curl -d password\r\n10. **代码执行风险** (high) — eval(拼接), exec(拼接), subprocess shell=True\r\n11. **敏感信息泄露** (high) — 硬编码 API key, Bearer token\r\n12. **路径遍历** (high) — ../../, %2e%2e, /etc/passwd\r\n\r\n### 注入攻击（13-15）\r\n\r\n13. **SQL 注入** (critical) — 字符串拼接 SELECT/WHERE\r\n14. **XSS 风险** (high) — innerHTML, document.write, v-html\r\n15. **不安全反序列化** (critical) — pickle.load, yaml.load 无 Loader\r\n\r\n### 凭证安全（16）\r\n\r\n16. **硬编码凭证** (high) — password=, secret=, private_key=\r\n\r\n### 加密安全（17）\r\n\r\n17. **不安全加密** (medium) — MD5, SHA1, DES, RC4, AES-ECB\r\n\r\n### 资源管理（18-19）\r\n\r\n18. **资源泄漏** (medium) — open() 无 close/with, connect() 无释放\r\n19. **竞态条件** (medium) — TOCTOU: if exists → open\r\n\r\n### 其他（20-25）\r\n\r\n20. **不安全随机数** (medium) — Math.random 用于安全场景\r\n21. **日志注入** (medium) — 用户输入直接写入日志\r\n22. **SSRF** (critical) — 用户输入构造请求 URL\r\n23. **XXE** (critical) — XML 解析未禁用外部实体\r\n24. **不安全 CORS** (medium) — Access-Control-Allow-Origin: *\r\n25. **依赖漏洞** (medium) — 已知漏洞的旧版本依赖\r\n\r\n## CWE 映射\r\n\r\n| 模式 | CWE |\r\n|------|-----|\r\n"},{"language":"text","snippet":"File v13.0.0:references/worktree-guide.md\n\n# Git Worktree 使用指南\r\n\r\n> 借鉴 Superpowers 的隔离开发设计，在模式 5（工作流编排）中实现主分支不受影响的隔离开发。\r\n\r\n## 什么是 Git Worktree\r\n\r\nGit worktree 允许你从同一个仓库创建多个工作目录，每个工作目录独立检出一个分支。这意味着你可以：\r\n\r\n- 在主分支保持不变的情况下，在新分支上开发功能\r\n- 同时处理多个功能，快速切换\r\n- 避免 `git stash` 的混乱\r\n\r\n## 目录结构"},{"language":"text","snippet":"File v13.0.0:CONTRIBUTING.md\n\n# coding-framework 扩展指南\r\n\r\n> 版本: 10.1.0 | 更新日期: 2026-06-29\r\n\r\n本文档说明如何扩展 coding-framework 的功能。\r\n\r\n---\r\n\r\n## 一、新增代理\r\n\r\n### 1.1 创建代理定义文件\r\n\r\n在 `agents/` 目录下创建 YAML 文件："},{"language":"text","snippet":"任务到达\n �? ├── 还不知道想要什么？ ──────�?interview-me\n ├── 有粗略概念，需要变体？ �?idea-refine\n ├── 新项�?功能/变更�?──�?spec-driven-development\n ├── 有规格，需要任务？ ──────�?planning-and-task-breakdown\n ├── 实现代码�?────────────�?incremental-implementation\n �? ├── UI 工作�?─────────────────�?frontend-design\n �? ├── API 工作�?────────────────�?api-and-interface-design\n �? ├── 需要更好的上下文？ ─────�?context-engineering\n �? ├── 需要文档验证的代码�?───�?source-driven-development\n �? └── 高风�?不熟悉的代码�?──�?doubt-driven-development\n ├── 编写/运行测试�?────────�?test-driven-development\n �? └── 基于浏览器？ ───────────�?browser-testing-with-devtools\n ├── 出问题了�?──────────────�?debugging-and-error-recovery\n ├── 审查代码�?───────────────�?code-review\n �? ├── 太复杂？ ─────────────�?code-simplifier\n �? ├── 安全问题�?───────�?security-and-hardening\n �? └── 性能问题�?───�?performance-optimization\n ├── 提交/分支�?─────────�?git-workflow-and-versioning\n ├── CI/CD 管道工作�?──────────�?ci-cd-and-automation\n ├── 弃用/迁移�?────────�?deprecation-and-migration\n ├── 写文�?ADR�?───────────�?documentation-and-adrs\n ├── 添加日志/指标/告警�?───�?observability-and-instrumentation\n └── 部署/发布�?─────────�?shipping-and-launch"},{"language":"text","snippet":"1. spec-driven-development �?定义规格\n2. planning-and-task-breakdown �?拆解任务\n3. incremental-implementation �?逐片实现\n4. test-driven-development �?编写测试\n5. code-review �?代码审查\n6. git-workflow-and-versioning �?提交代码"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: coding-framework\r\ndescription: \"Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr...\"\r\ntags: [coding, backend, multi-agent, iterative, template-based]\r\nversion: 13.0.0\r\ndependencies:\r\n skills: [\"code-review\", \"brainstorming\", \"debugging-and-error-recovery\"]\r\n---\r\n\r\n# Coding Framework �?统一编程框架 v12.2.0\r\n\r\n## 你是谁？\r\n你是一个资深编程框架，整合了业界最佳实践：\r\n- Claude Code �?Hook 事件系统和多代理审查\r\n- Claude Plugins Official 的安全审核和渐进式披�?- OpenAI Codex 的标准化代理定义和安全沙�?- Ponytail �?YAGNI 决策阶梯和代码精简哲学\r\n- **Karpathy 四原�?*（v11.5 新增）：LLM 编码行为准则\r\n- **Anthropic 官方技能体�?*（v11.6 新增）：24 个开发阶段技能路�?---\r\n\r\n## Step 0: 开发阶段检测（v11.6 新增�?> 参考：`using-agent-skills` skill 的开发阶段决策树\r\n\r\n在开始编码前，先检测当前任务处于哪个开发阶段，加载对应的技能：\r\n\r\n```\r\n任务到达\r\n �? ├── 还不知道想要什么？ ──────�?brainstorming（设计门�?创意打磨�? ├── 新项�?功能/变更 ────────�?spec-driven-development\r\n ├── 有规格，需要任务？ ──────�?planning-and-task-breakdown\r\n ├── 实现代码 ────────────────�?incremental-implementation\r\n �? ├── UI 工作 ─────────────────�?frontend-design\r\n �? ├── API 工作 ────────────────�?api-and-interface-design\r\n �? ├── 需要更好的上下文？ ─────�?context-engineering\r\n �? ├── 需要文档验证的代码�?───�?source-driven-development\r\n �? └── 高风�?不熟悉的代码�?──�?doubt-driven-development\r\n ├── 编写/运行测试 ─────────�?test-driven-development\r\n �? └── 基于浏览器？ ───────────�?browser-testing-with-devtools\r\n ├── 出问题了�?──────────────�?debugging-and-error-recovery\r\n ├── 审查代码�?──────────────�?code-review\r\n �? ├── 太复杂？ ─────────────�?code-simplifier\r\n �? ├── 安全问题�?───────�?security-and-hardening\r\n �? └── 性能问题�?───�?performance-optimization\r\n ├── 提交/分支 ─────────�?git-workflow-and-versioning\r\n ├── CI/CD 管道工作 ───────────�?ci-cd-and-automation\r\n ├── 弃用/迁移 ─────────�?deprecation-and-migration\r\n ├── 写文�?ADR�?───────────�?documentation-and-adrs\r\n ├── 添加日志/指标/告警 ───�?observability-and-instrumentation\r\n └── 部署/发布 ─────────�?shipping-and-launch\r\n```\r\n\r\n### 阶段检测规�?**检测关键词**�?| 阶段 | 关键�?| 加载技�?|\r\n|------|--------|---------|\r\n| 需求澄�?想法精炼 | 想要什么、想法、概念、变体、头脑风�?| brainstorming |\r\n| 规格定义 | 规格、PRD、需求文�?| spec-driven-development |\r\n| 任务分解 | 任务、拆解、计�?| planning-and-task-breakdown |\r\n| 代码实现 | 实现、编码、开�?| incremental-implementation |\r\n| UI 开�?| UI、界面、组件、样�?| frontend-design |\r\n| API 开�?| API、接口、端�?| api-and-interface-design |\r\n| 测试编写 | 测试、TDD、单元测�?| test-driven-development |\r\n| 调试修复 | 调试、bug、修�?| debugging-and-error-recovery |\r\n| 代码审查 | 审查、review、检�?| code-review |\r\n| 代码简�?| 简化、重构、优化结�?| code-simplifier |\r\n| 安全加固 | 安全、漏洞、加�?| security-and-hardening |\r\n| 性能优化 | 性能、优化、加�?| performance-optimization |\r\n| Git 操作 | 提交、分支、合�?| git-workflow-and-versioning |\r\n| CI/CD | CI、CD、流水线 | ci-cd-and-automation |\r\n| 弃用迁移 | 弃用、迁移、升�?| deprecation-and-migration |\r\n| 文档编写 | 文档、ADR、说�?| documentation-and-adrs |\r\n| 可观测�?| 日志、指标、监�?| observability-and-instrumentation |\r\n| 部署发布 | 部署、发布、上�?| shipping-and-launch |\r\n\r\n### 🔴 防跳过机制：Red Flags 表格（v11.7 新增�?> 参考：Superpowers using-superpowers skill �?Red Flags 设计\r\n> \r\n> **核心原则**：即使只�?1% 的可能性适用某"},{"path":"plans/README.md","content":"��# Plans Directory\n\nPlan files generated by Plan Mode (!j\u000f_6) are stored here.\n\nFormat: plan-YYYYMMDD-HHMMSS.md"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn73z7zhz92tv6skpnmpy5pdfh86j68x\",\n \"slug\": \"coding-framework\",\n \"version\": \"13.0.0\",\n \"publishedAt\": 1785718505468\n}"},{"path":"references/agent-system.md","content":"# 代理系统完整文档\r\n\r\n> coding-framework 的标准化编程代理定义和调度系统。\r\n\r\n## 概述\r\n\r\n代理系统提供 7 个专业代理，每个代理有明确的职责、工具权限和输出格式。\r\n灵感来源：Claude Code 代理定义 + Codex YAML 格式 + OpenAI Codex 安全沙箱。\r\n\r\n## 代理定义规范\r\n\r\n每个代理使用 YAML 文件定义，存放于 `agents/` 目录：\r\n\r\n```yaml\r\nname: agent-id # 唯一标识符\r\ndisplay_name: \"显示名称\" # 中文友好名称\r\ndescription: \"职责描述\" # 一句话说明\r\nmodel: sonnet # 推荐模型\r\ncolor: green # UI 显示颜色\r\ntools: # 允许使用的工具\r\n - Read\r\n - Grep\r\ntrigger_examples: # 触发示例\r\n - \"示例消息\"\r\nsystem_prompt: | # 系统提示\r\n 详细的系统提示文本...\r\n```\r\n\r\n## 代理列表\r\n\r\n### code-reviewer（代码审查员）\r\n\r\n- **职责**：代码质量、可维护性、最佳实践 + Ponytail 决策阶梯\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：审查报告 + 评分（代码质量/可维护性/最佳实践/精简度）\r\n- **特色**：集成 YAGNI 决策阶梯，识别过度抽象\r\n\r\n### security-auditor（安全审计员）\r\n\r\n- **职责**：安全漏洞、敏感信息、权限风险 + 25 种安全模式\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：安全报告 + CWE 编号 + 安全评分\r\n- **特色**：覆盖 25 种安全模式，从注入到依赖漏洞\r\n\r\n### test-engineer（测试工程师）\r\n\r\n- **职责**：测试用例生成、覆盖率分析、测试策略\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：测试用例列表 + 测试代码 + 覆盖率建议\r\n- **特色**：单元/集成/边界/异常全覆盖\r\n\r\n### architecture-critic（架构批评家）\r\n\r\n- **职责**：模块划分、依赖关系、设计模式、扩展性\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：SRP/开闭原则/循环依赖检测\r\n\r\n### performance-analyst（性能分析师）\r\n\r\n- **职责**：算法复杂度、资源泄漏、I/O 性能、并发\r\n- **工具**：Read, Grep, Glob, exec\r\n- **输出**：JSON 结构化发现 + 复杂度标注\r\n- **特色**：N+1 检测、内存泄漏识别、可量化优化建议\r\n\r\n### maintainability-reviewer（可维护性审查员）\r\n\r\n- **职责**：命名质量、函数设计、复杂度、技术债务\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：TODO/FIXME 检测、圈复杂度分析\r\n\r\n### documentation-checker（文档检查员）\r\n\r\n- **职责**：API 文档、代码注释、README 完整性\r\n- **工具**：Read, Grep, Glob\r\n- **输出**：JSON 结构化发现 + 评分\r\n- **特色**：文档一致性检查、示例代码建议\r\n\r\n## 调度逻辑\r\n\r\n```\r\n用户请求 → 识别任务类型\r\n → 关键词匹配（trigger_examples）\r\n → 文件类型匹配（扩展名）\r\n → 任务类型匹配（审查/安全/测试）\r\n → 默认回退：code-reviewer\r\n```\r\n\r\n调度优先级：security-auditor > test-engineer > code-reviewer\r\n\r\n## 与 sessions_spawn 集成\r\n\r\n```\r\n用户请求 → coding-framework 识别任务类型\r\n → 加载对应 agents/*.yaml\r\n → sessions_spawn(\r\n model: agent.model,\r\n system_prompt: agent.system_prompt,\r\n task: 用户请求 + 上下文\r\n )\r\n → 等待子代理返回\r\n → 格式化输出\r\n```\r\n\r\n## 输出格式规范\r\n\r\n所有代理输出遵循统一格式：\r\n\r\n```markdown\r\n## [代理名称] 审查结果\r\n\r\n### 概要\r\n一句话总结发现。\r\n\r\n### 详细发现\r\n1. **[严重程度]** 问题描述\r\n - 位置：文件:行号\r\n - 建议：修复方案\r\n\r\n### 评分\r\n- 整体评分：X/10\r\n- 置信度：X%\r\n```\r\n\r\n## 自定义代理\r\n\r\n在 `agents/` 下创建新的 `.yaml` 文件，确保：\r\n- `name` 唯一\r\n- `system_prompt` 足够详细\r\n- `trigger_examples` 覆盖常见场景\r\n- `tools` 最小权限原则"},{"path":"references/external-agents.md","content":"# 外部编码代理委派模式\r\n\r\n> 来源：coding-agent skill，适配 coding-framework\r\n> 版本：10.1.0（v10.1 新增安全警告和冲突处理）\r\n\r\n## 概述\r\n\r\n当任务需要外部编码代理（Codex / Claude Code / Pi）时，使用本指南。\r\n\r\n**核心原则**：coding-framework 负责质量治理，外部代理负责执行。\r\n\r\n---\r\n\r\n## 1. 代理选择\r\n\r\n| 代理 | 调用方式 | 适用场景 |\r\n|------|----------|----------|\r\n| Claude Code | `claude --print 'task'` | 复杂重构、代码生成 |\r\n| Codex | `bash pty:true command:\"codex exec --full-auto 'task'\"` | 快速修复、批量任务 |\r\n| Pi | `bash pty:true command:\"pi 'task'\"` | 轻量任务 |\r\n\r\n---\r\n\r\n## 2. 调用模式\r\n\r\n### Claude Code（非交互）\r\n\r\n```bash\r\n# 前台执行（推荐：使用权限白名单）\r\nbash workdir:~/project command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\r\n\r\n# 后台执行\r\nbash workdir:~/project background:true command:\"claude --allowedTools 'Read,Write,Edit' --print 'Your task'\"\r\n```\r\n\r\n> ⚠️ **安全警告（v10.1 新增）**：\r\n> \r\n> `--permission-mode bypassPermissions` 绕过所有权限检查，**仅适用于完全隔离的沙箱环境**（如 Docker 容器、临时 VM）。\r\n> \r\n> **不推荐在本地开发环境使用**。生产环境请使用 `--allowedTools` 白名单模式。\r\n\r\n### Codex（PTY 模式）\r\n\r\n```bash\r\n# 快速一次性任务\r\nbash pty:true workdir:~/project command:\"codex exec --full-auto 'Add error handling'\"\r\n\r\n# 后台长任务\r\nbash pty:true workdir:~/project background:true command:\"codex --yolo 'Refactor auth module'\"\r\n```\r\n\r\n**注意**：Codex 需要 Git 仓库环境，临时任务用 `mktemp -d && git init`。\r\n\r\n---\r\n\r\n## 3. Git Worktree 并行修复\r\n\r\n用于同时修复多个 Issue，每个 worktree 独立工作目录：\r\n\r\n```bash\r\n# 1. 创建 worktree\r\ngit worktree add -b fix/issue-78 /tmp/issue-78 main\r\ngit worktree add -b fix/issue-99 /tmp/issue-99 main\r\n\r\n# 2. 在每个 worktree 启动代理\r\nbash pty:true workdir:/tmp/issue-78 background:true command:\"codex --yolo 'Fix issue #78: . Commit and push.'\"\r\nbash pty:true workdir:/tmp/issue-99 background:true command:\"codex --yolo 'Fix issue #99. Commit and push.'\"\r\n\r\n# 3. 监控进度\r\nprocess action:list\r\nprocess action:log sessionId:XXX\r\n\r\n# 4. 创建 PR\r\ncd /tmp/issue-78 && git push -u origin fix/issue-78\r\ngh pr create --head fix/issue-78 --title \"fix: ...\" --body \"...\"\r\n\r\n# 5. 清理\r\ngit worktree remove /tmp/issue-78\r\n```\r\n\r\n### Worktree 冲突处理（v10.1 新增）\r\n\r\n**约束**：worktree 任务必须修改不相交的文件集。\r\n\r\n**冲突检测脚本**：\r\n\r\n```bash\r\n#!/bin/bash\r\n# check-worktree-conflict.sh\r\n# 检查多个 worktree 是否修改了相同文件\r\n\r\nWORKTREES=(\"$@\")\r\nCONFLICT_FILES=\"\"\r\n\r\nfor wt in \"${WORKTREES[@]}\"; do\r\n files=$(cd \"$wt\" && git diff --name-only HEAD 2>/dev/null)\r\n for f in $files; do\r\n if echo \"$CONFLICT_FILES\" | grep -q \"$f\"; then\r\n echo \"⚠️ 冲突文件: $f (在多个 worktree 中被修改)\"\r\n else\r\n CONFLICT_FILES=\"$CONFLICT_FILES $f\"\r\n fi\r\n done\r\ndone\r\n\r\nif [ -z \"$CONFLICT_FILES\" ]; then\r\n echo \"✅ 无文件冲突\"\r\nelse\r\n echo \"📋 已修改文件: $CONFLICT_FILES\"\r\nfi\r\n```\r\n\r\n**使用方式**：\r\n\r\n```bash\r\n# 启动 worktree 前检查\r\nbash check-worktree-conflict.sh /tmp/issue-78 /tmp/issue-99\r\n\r\n# 如果检测到冲突，调整任务分配\r\n```\r\n\r\n---\r\n\r\n## 4. 完成自动通知\r\n\r\n在任务 prompt 末尾追加通知命令：\r\n\r\n```bash\r\ncodex --yolo exec 'Build a REST API.\r\n\r\nWhen completely finished, run:\r\nopenclaw system event --text \"Done: Built REST API with CRUD endpoints\" --mode now'\r\n```\r\n\r\n效果：任务完成后立即触发 wake event，无需轮询。\r\n\r\n> **依赖说明**：`openclaw` 命令需要在 P"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Skill: coding-framework Owner: paudyyin Summary: Orchestrate the complete coding workflow with multiple development modes (TDD/incremental/spec-dr... Tags: latest:13.0.0 Version history: v13.0.0 | 2026-08-03T00:55:05.468Z | auto Version 13.0.0 (coding-framework) – Major update with new structure and advanced multi-skill orchestration - Refactored SKILL.md: now includes explicit skill path mapping and extended modular","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":896,"uniquenessScore":57,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T18:51:56.978Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T10:45:28.420Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}