{"id":"c7366d02-1c8c-4b87-8b80-17c89836ea20","entityType":"agent","slug":"clawhub-ldxs001-triphasic-execution","name":"triphasic-execution","canonicalUrl":"https://www.xpersona.co/agent/clawhub-ldxs001-triphasic-execution","canonicalPath":"/agent/clawhub-ldxs001-triphasic-execution","generatedAt":"2026-10-10T21:40:22.684Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T19:06:13.786Z","emptyReason":null},"description":"Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:triphasic-execution","sourceUrl":"https://clawhub.ai/ldxs001/triphasic-execution","homepage":"https://clawhub.ai/ldxs001/skills/triphasic-execution","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/ldxs001/triphasic-execution","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/ldxs001/skills/triphasic-execution","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"triphasic-execution technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T19:06:13.786Z","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-10T19:06:13.786Z","emptyReason":null},"stars":null,"forks":null,"downloads":1285,"packageName":null,"latestVersion":"5.19.1","tractionLabel":"1.3K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T19:06:13.785Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T19:06:13.786Z","lastCrawledAt":"2026-10-10T19:06:13.785Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T19:06:13.785Z","lastVerifiedAt":null,"highlights":[{"version":"5.19.1","createdAt":"2026-06-25T10:26:07.873Z","changelog":"**Enforces stricter protocol for step-execution, adds config UI, and updates file/data layout.** - Added HTML configuration interface (`assets/settings.html`) and Python config UI script (`scripts/settings.py`). - Enhanced enforcement of mandatory constraints (F-05, F-06, F-08, F-11) via new script hooks and clearer status outputs. - Updated and clarified core capabilities and workflow documentation. - Changed data directory structure (`data_dir`, directory names in references/usage). - Synchronized meta fields; cleaned and standardized SKILL.md. - Removed legacy `skill-card.md`; updated scripts to align with revised flow and constraints.","fileCount":20,"zipByteSize":74166},{"version":"5.17.3","createdAt":"2026-05-30T19:51:13.949Z","changelog":"- Removed four documentation and progress-related files: skill-card.md and three temp_progress JSONs. - Cleaned up the project by deleting unused or temporary files. - No changes to core logic; operational behavior is unchanged.","fileCount":18,"zipByteSize":58081},{"version":"5.17.1","createdAt":"2026-05-28T17:04:53.830Z","changelog":"- Data directory migrated to ~/.workbuddy/.standardization/triphasic-execution/ (aligned with R-11/R-12). - Added strict post-task output protocol: AI must execute 3 steps (complete, problem log, lessons merge) after each task. - cmd_add now synchronizes writes to PROBLEMS.md. - Fixed path handling in task_progress.py complete. - Documentation in SKILL.md updated to reflect new enforcement and data directory.","fileCount":21,"zipByteSize":60431},{"version":"5.17.0","createdAt":"2026-05-28T11:22:15.510Z","changelog":"- Major update: enhanced semantic understanding and task step planning flow. - Improved semantic split using 5W2H extraction with constraint marking. - Enhanced step planning logic, referencing \"skill-sub\" methods for robust execution plans. - Explicit flow rules for idle (空转), retries, changing strategy, and help requests—max 3 idle and 3 retry cycles enforced. - New mandatory constraints: max 3 idle per step (F-11), full cycle for change-strategy (F-12), and no returning to completed steps (F-13). - Updated documentation to include these new rules and the absence of (some) removed configuration and UI files.","fileCount":18,"zipByteSize":57121},{"version":"5.15.0","createdAt":"2026-05-25T07:54:28.786Z","changelog":"triphasic-execution v5.15.0 - 修复渐进式加载说明和触发条件否定条件，细化技能加载逻辑。 - 统一术语（如“设置”→“配置”），修正中英文混排及拼写错误（task_progress.py）。 - 增加/补全 references/antipatterns.md、references/faq.md、references/permissions.md，移除 references/permission.md。 - 补充与显式化渐进式 MD 文件体系说明，提升文档一致性和可维护性。 - 新增权限相关元数据与安全标签（如 permission_weight: CRITICAL）。 - 丰富常见问题、反模式等辅助文档（通过新分离的 .md 文件实现）。","fileCount":21,"zipByteSize":60482},{"version":"5.14.0","createdAt":"2026-05-24T15:30:46.892Z","changelog":"- 新增 references/permission.md，提供权限说明文档 - 新增 references/permission_report.json，增加权限报告数据 - 为权限管理和说明提供更清晰的独立参考资料","fileCount":18,"zipByteSize":54803},{"version":"5.13.0","createdAt":"2026-05-24T14:48:26.742Z","changelog":"v5.13.0: 权限权重与风险补充 - 增加了权限权重说明（R-16），强调任务和操作风险的权重分类。 - references/reference.md 中新增了权限权重表格与风险等级评估内容，为流程提供更全面的合规与安全参考。 - 保障执行流程时对关键权限、操作风险做出结构化提示与管理。 - 其余核心框架与既有流程不变。","fileCount":16,"zipByteSize":52025},{"version":"5.11.0","createdAt":"2026-05-23T11:29:12.570Z","changelog":"**v5.11.0 introduces output directory relocation and dynamic path functions.** - All output/data paths moved to skills/.standardization/triphasic-execution/data/ - Added get_standardization_dir() in settings.py for dynamic directory location - default_config.json, settings.html, and reference.md updated to reflect new paths - Added references/changelog.md file - Removed default_config.json file","fileCount":16,"zipByteSize":49722}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:triphasic-execution","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s1794v2r46s8y5d1r4jdd7ec5h84rw70:triphasic-execution` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/ldxs001/triphasic-execution before using production credentials."],"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-ldxs001-triphasic-execution/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/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-10T21:40:22.680Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-ldxs001-triphasic-execution/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":"medium","updatedAt":"2026-10-10T19:06:13.786Z","emptyReason":null},"readme":"Skill: triphasic-execution\n\nOwner: ldxs001\n\nSummary: Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。\n\nTags: latest:5.19.1\n\nVersion history:\n\nv5.19.1 | 2026-06-25T10:26:07.873Z | auto\n\n**Enforces stricter protocol for step-execution, adds config UI, and updates file/data layout.**\n\n- Added HTML configuration interface (`assets/settings.html`) and Python config UI script (`scripts/settings.py`).\n- Enhanced enforcement of mandatory constraints (F-05, F-06, F-08, F-11) via new script hooks and clearer status outputs.\n- Updated and clarified core capabilities and workflow documentation.\n- Changed data directory structure (`data_dir`, directory names in references/usage).\n- Synchronized meta fields; cleaned and standardized SKILL.md.\n- Removed legacy `skill-card.md`; updated scripts to align with revised flow and constraints.\n\nv5.17.3 | 2026-05-30T19:51:13.949Z | user\n\n- Removed four documentation and progress-related files: skill-card.md and three temp_progress JSONs.\n- Cleaned up the project by deleting unused or temporary files.\n- No changes to core logic; operational behavior is unchanged.\n\nv5.17.1 | 2026-05-28T17:04:53.830Z | user\n\n- Data directory migrated to ~/.workbuddy/.standardization/triphasic-execution/ (aligned with R-11/R-12).\n- Added strict post-task output protocol: AI must execute 3 steps (complete, problem log, lessons merge) after each task.\n- cmd_add now synchronizes writes to PROBLEMS.md.\n- Fixed path handling in task_progress.py complete.\n- Documentation in SKILL.md updated to reflect new enforcement and data directory.\n\nv5.17.0 | 2026-05-28T11:22:15.510Z | user\n\n- Major update: enhanced semantic understanding and task step planning flow.\n- Improved semantic split using 5W2H extraction with constraint marking.\n- Enhanced step planning logic, referencing \"skill-sub\" methods for robust execution plans.\n- Explicit flow rules for idle (空转), retries, changing strategy, and help requests—max 3 idle and 3 retry cycles enforced.\n- New mandatory constraints: max 3 idle per step (F-11), full cycle for change-strategy (F-12), and no returning to completed steps (F-13).\n- Updated documentation to include these new rules and the absence of (some) removed configuration and UI files.\n\nv5.15.0 | 2026-05-25T07:54:28.786Z | user\n\ntriphasic-execution v5.15.0\n\n- 修复渐进式加载说明和触发条件否定条件，细化技能加载逻辑。\n- 统一术语（如“设置”→“配置”），修正中英文混排及拼写错误（task_progress.py）。\n- 增加/补全 references/antipatterns.md、references/faq.md、references/permissions.md，移除 references/permission.md。\n- 补充与显式化渐进式 MD 文件体系说明，提升文档一致性和可维护性。\n- 新增权限相关元数据与安全标签（如 permission_weight: CRITICAL）。\n- 丰富常见问题、反模式等辅助文档（通过新分离的 .md 文件实现）。\n\nv5.14.0 | 2026-05-24T15:30:46.892Z | user\n\n- 新增 references/permission.md，提供权限说明文档 \n- 新增 references/permission_report.json，增加权限报告数据 \n- 为权限管理和说明提供更清晰的独立参考资料\n\nv5.13.0 | 2026-05-24T14:48:26.742Z | user\n\nv5.13.0: 权限权重与风险补充 \n- 增加了权限权重说明（R-16），强调任务和操作风险的权重分类。 \n- references/reference.md 中新增了权限权重表格与风险等级评估内容，为流程提供更全面的合规与安全参考。 \n- 保障执行流程时对关键权限、操作风险做出结构化提示与管理。 \n- 其余核心框架与既有流程不变。\n\nv5.11.0 | 2026-05-23T11:29:12.570Z | user\n\n**v5.11.0 introduces output directory relocation and dynamic path functions.**\n\n- All output/data paths moved to skills/.standardization/triphasic-execution/data/\n- Added get_standardization_dir() in settings.py for dynamic directory location\n- default_config.json, settings.html, and reference.md updated to reflect new paths\n- Added references/changelog.md file\n- Removed default_config.json file\n\nv5.10.0 | 2026-05-23T04:02:11.648Z | user\n\nv5.10.0 标准化与结构优化更新：\n\n- 新增 references/examples.md、references/mandatory.md、references/reference.md，主规则和示例拆分至独立文件\n- SKILL.md 重写为标准 200 行版本，新增「触发条件」「核心能力」章节\n- 保留摘要、流程与快速命令，将详细规则、模板、示例移至 references/\n- 不变核心循环与强制约束，整体结构更清晰易用\n- 版本描述统一为 skill-standardization 规范改造\n\nv5.9.0 | 2026-05-21T17:23:48.027Z | user\n\nTriphasic-execution v5.9.0\n\n- Standardized metadata: Added _meta.json with 5 fields (name, version, description, author, tags)\n- Updated author field to \"wUwproject\" for consistency\n- Removed agent_created field from metadata\n- No core logic or behavioral changes to the execution framework\n\nv5.8.0 | 2026-05-19T04:57:19.975Z | auto\n\nTriphasic Execution v5.8.0 introduces a transparent loading protocol and fully hardens execution constraints.\n\n- Added LOADING PROTOCOL: skill now outputs a [triphasic] loaded status after load, making execution order visible.\n- Replaced all \"must\" and \"should\" with [MANDATORY] absolute constraints F-01~F-10, which are now placed at the top for early self-checks.\n- Removed the previously mandatory confirmation mechanism for executing plans (F-00).\n- Enforced pre-execution semantic parsing and tightened step-by-step self-inspection at each phase.\n- Significantly restructured documentation for clarity and compliance checking.\n- Dropped `install.py` and `problem_daemon.py` from distribution, reflecting process streamlining.\n\nv5.6.0 | 2026-05-18T12:24:47.948Z | user\n\nv5.6.0 introduces persistent task progress tracking for improved reliability.\n\n- 新增“临时进度文件”（JSON），任务规划阶段自动创建，跟踪每个任务执行进度\n- 每步执行后自动更新进度文件，实现任务状态实时持久化，防止进度丢失\n- 任务全部完成后自动删除进度文件；如遇中断可通过进度文件恢复进度\n- 新增 scripts/task_progress.py 脚本，统一管理进度文件的创建、更新和清理\n\nv5.4.0 | 2026-05-18T04:02:23.391Z | user\n\nTriphasic Execution v5.4.0\n\n- 新增任务拆分时【强制问题/风险/经验记录步骤】，任务管理更结构化。\n- 允许用户选择是否在执行时跳过问题/风险/经验登记，提升灵活性。\n- 定时任务完成后支持人机交互补充与审查（例如推送通知后用户可补记问题与经验）。\n- 调整定时任务、任务拆分等节点的信息登记规则，问题、风险、经验记录入口更清晰。\n- 文档显著更新，梳理全局模式与临时调用的功能边界与适用场景。\n\nArchive index:\n\nArchive v5.19.1: 20 files, 74166 bytes\n\nFiles: _meta.json (139b), assets/settings.html (22499b), references/antipatterns.md (4114b), references/changelog.md (8950b), references/examples.md (5862b), references/faq.md (5594b), references/mandatory.md (18644b), references/permission_report.json (11588b), references/permissions.md (2304b), references/reference.md (8338b), scripts/cron_helper.py (4633b), scripts/exec_wrapper.py (13074b), scripts/install.py (8704b), scripts/lessons_register.py (6620b), scripts/problem_daemon.py (20699b), scripts/problem_logger.py (21105b), scripts/settings.py (24182b), scripts/task_progress.py (39136b), skill-card.md (2714b), SKILL.md (11131b)\n\nFile v5.19.1:SKILL.md\n\n---\r\nname: triphasic-execution\r\nversion: 5.19.1\r\nauthor: wUwproject\r\nlicense: MIT\r\ndescription: Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。\r\ntags: ['framework', 'execution', 'debugging', 'problem-tracking', 'risk-tracking', 'lessons-learned', 'cross-platform', 'configuration', 'config-ui']\r\ncategory: workflow\r\ntrigger: ['三步循环', 'Execute', 'Review', 'Advance', '步骤', 'pre_exec', 'verify_exec', 'retry', 'idle']\r\ntrigger_negative: true\r\nsensitive_access: false\r\ncritical_write: false\r\npermission_weight: LOW\r\ndata_dir: ../.standardization/triphasic-execution/data/\r\nexternal_data_dir: true\r\nmeta_field_sync: true\r\nh1_position: true\r\n---\r\n# Triphasic Execution Framework\r\n执行 → 审查 → 推进。每次交互只做一件事，三者缺一不可。\r\n\r\n> → 详见 `references/antipatterns.md`\r\n> → 详见 `references/faq.md`\r\n\r\n---\r\n\r\n## 触发条件\r\n\r\n**正向触发（满足以下任意一条）：**\r\n\r\n- 说出\"三步执行\"、\"执行审查推进\"、\"triphasic\"\r\n- 说出\"问题记录\"、\"经验教训\"、\"problem logger\"\r\n- 说出\"打开 triphasic 配置\"、\"triphasic config\"\r\n- 需要结构化执行框架防止死循环或跳步\r\n- 复杂多步骤任务，需要强制进度追踪和中断恢复\r\n\r\n**否定条件（满足以下任意一条，不触发）：**\r\n\r\n- 简单问答、闲聊、问候（不需要结构化执行）\r\n- 单步任务（如\"查看文件\"、\"运行命令\"等一步完成的操作）\r\n- 用户明确说\"不要使用 triphasic\"或\"关闭 triphasic\"\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n\r\n---\r\n\r\n## 核心能力\r\n\r\n> 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。\r\n\r\n| # | 能力 | 说明 |\r\n|---|------|------|\r\n| 1 | **语义理解增强（F-01+）** | 参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力；详见 `references/mandatory.md` Phase 0 |\r\n| 2 | **步骤规划增强（F-02+）** | 参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）；详见 `references/mandatory.md` Phase 1 |\r\n| 3 | **三步循环执行** | Execute→Review→Advance，每步必须完整，不可跳过 |\r\n| 4 | **进度文件持久化（F-03/F-07/F-09）** | init→update→complete，中断后可 resume 恢复；**complete 强制校验（v5.12）** |\r\n| 5 | **问题/风险/经验记录** | 任务完成后强制记录（复杂任务 Python 侧校验），积累 PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md |\r\n| 6 | **最多 3 次重试（F-08）** | 同一步骤失败 3 次必须换方案，禁止第 4 次重试 |\r\n| 7 | **最多 3 次空转（F-11）** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，禁止第 4 次空转 |\r\n| 8 | **双模式支持** | 按需调用模式（默认）/ 全局自动模式 |\r\n| 9 | **HTML 配置界面** | `settings.py` 可视化配置技能参数 |\r\n\r\n---\r\n\r\n## 空转/重试/换思路/求助 流转规则\r\n\r\n> 详细规则见 `references/mandatory.md` Phase 2~4。\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n```bash\r\n# 按需调用（默认）— 任务开头说出关键词即可\r\n\"使用 triphasic-execution 执行以下任务：...\"\r\n\r\n# 全局自动模式 — 所有任务自动套用框架\r\n编辑 data/default_config.json → \"mode\": \"auto\"\r\n\r\n# 可视化配置\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## ⚡ [LOADING PROTOCOL]\r\n\r\nskill 加载后，AI 输出以下状态标识：\r\n\r\n```\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n```\r\n\r\n| 观察结果 | 结论 |\r\n|---------|------|\r\n| 状态输出在任务相关内容之前出现 | ✅ 执行顺序正确 |\r\n| 状态输出在任务执行后才出现 | ❌ 执行顺序错误 |\r\n| 无状态输出 | ❌ skill 未加载 |\r\n\r\n---\r\n\r\n## 🚨 [MANDATORY] 强制约束总表\r\n\r\n> **本节是整个技能的执行宪法。违反任意一条 = 违规，必须立即停止并补救。**\r\n\r\n| 序号 | 约束内容 | 触发时机 | Python 强制 |\r\n|------|---------|---------|------------|\r\n| **F-01** | 收到任务后首先执行语义拆分，禁止直接进入规划 | 收到任务第一个响应 | ❌ AI 自觉 |\r\n| **F-02** | 语义拆分完成后必须输出【任务规划】，禁止直接执行 | 语义拆分输出后 | ❌ AI 自觉（需用户确认规划）|\r\n| **F-03** | 任务规划输出后立即调用 `task_progress.py init` | 规划确认后 | ✅ 文件不存在则后续 update/complete 报错 |\r\n| **F-04** | 每步 EXECUTE 开始前重述本步骤任务目的 | 每步执行前 | ❌ AI 自觉 |\r\n| **F-05** | 每步执行后必须紧跟 REVIEW，禁止连续执行两步 | 每步执行后 | ✅ `pre_exec_search` 钩子拦截未 REVIEW 的执行 |\r\n| **F-06** | 每步 REVIEW 后必须紧跟 ADVANCE | 每步 REVIEW 后 | ✅ `block_skip_review` 钩子拦截未 REVIEW 的下一步 |\r\n| **F-07** | 每步 ADVANCE 后调用 `task_progress.py update` | 每步 ADVANCE 后 | ✅ update 校验 init 存在性 |\r\n| **F-08** | 同一步骤失败 3 次后必须换方案，禁止第 4 次重试 | 重试计数达到 3 | ✅ 脚本强制（`retries>=3 → sys.exit(1)`）|\r\n| **F-09** | 任务完成后调用 `task_progress.py complete` | 任务完成时 | ✅ **v5.12 强制**：校验步骤完成率、记录文件、summary.json |\r\n| **F-10** | 任务完成后必须输出【任务完成】总结 | 任务结束时 | ⚠️ 部分（summary.json 自动生成）|\r\n| **F-11** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入 | 空转计数达到 3 | ✅ `auto_idle_cutoff` 钩子自动 abort（默认关）|\r\n| **F-12** | 换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环 | 换思路请求产生时 | ❌ AI 自觉（LLM 决策流程，无法脚本化）|\r\n| **F-13** | 推进阶段成功后，坚决不倒回已画√的步骤 | 推进决策时 | ❌ AI 自觉（LLM 决策流程，无法脚本化）|\r\n\r\n### 自检指令\r\n\r\n```\r\n[自检] 当前阶段：[阶段名称]\r\n- F-01 语义拆分：[已完成/待执行]\r\n- F-02 任务规划：[已完成/待执行]\r\n- F-03 进度文件创建：[已完成/待执行]\r\n- 当前步骤 N：[待执行/执行中/已完成]\r\n- 重试计数：[0/1/2/3/超次]\r\n- 空转计数：[0/1/2/3/超次]\r\n违规项：[无/F-XX 描述]\r\n```\r\n\r\n---\r\n\r\n## 工作流程\r\n\r\n```\r\n用户任务\r\n ↓ [F-01 MANDATORY]\r\n语义拆分 → 输出块分析（主语/目的/诉求/动机）[增强：5W2H + 约束标注]\r\n ↓ [F-02 MANDATORY]\r\n任务规划 → 明确目的/要求/工具/结果/风险 → 确认执行 [增强：参考 skill-sub 规划逻辑]\r\n ↓ [F-03 MANDATORY]\r\ntask_progress.py init → 创建进度文件\r\n ↓\r\n执行循环（每步骤）：\r\n 🔧 EXECUTE（重述目的 → 执行）[空转计数]\r\n ↓ [F-05]\r\n 🔍 REVIEW（✅/❌/⚠️ + 证据）[重试计数/空转计数]\r\n ↓ [F-06]\r\n 📍 ADVANCE（继续/换方案/求助/完成）[截断/触发词重启]\r\n ↓ [F-07]\r\n task_progress.py update\r\n ↓\r\n任务完成\r\n ↓ [F-09] task_progress.py complete\r\n ↓ [F-10] 输出【任务完成】总结\r\n ↓ [MANDATORY] 问题/风险/经验记录\r\n```\r\n\r\n### 🔴 任务完成后的强制输出协议（AI 必读）\r\n\r\n> **每完成一个任务后，AI 必须执行以下 3 步，不可跳过。**\r\n> 不管任务成败，只要有实际工作产出，就必须记录。\r\n\r\n| 步骤 | 命令 | 说明 |\r\n|------|------|------|\r\n| 1 | `task_progress.py complete --task \"名称\"` | 完成任务，强制校验记录文件 |\r\n| 2 | `problem_logger.py add --scene \"场景\" --symptom \"现象\" --cause \"原因\" --solution \"方案\" --task \"任务\"` | 每遇到一个非 trivial 问题都记录 |\r\n| 3 | `problem_logger.py merge-to-lessons` | 任务完全完成后，合并所有待合并条目到 LESSONS_REGISTER.md |\r\n\r\n→ 完整用法见下方「快速命令」章节\r\n→ 数据目录：`skills/.standardization/triphasic-execution/`（符合 R-11/R-12 规范）\r\n→ 结构规范：`data/`(进度文件) `output/`(记录文件) `logs/`(日志) `temp/`(临时文件)\r\n\r\n→ 详细规则、模板、禁止行为清单见 `references/mandatory.md`\r\n→ 完整示例见 `references/examples.md`\r\n→ CLI 命令、进度文件、数据目录、安装见 `references/reference.md`\r\n\r\n---\r\n\r\n## 循环规则（摘要）\r\n\r\n1. **语义拆分先行** — 收到任务的第一个动作（增强：5W2H + 约束强度标注）\r\n2. **规划先行** — 所有任务必须先输出任务规划（增强：参考 skill-sub 规划逻辑）\r\n3. **临时文件持久化** — init → update（每步）→ complete\r\n4. **最小单元** — 单次工具调用，每步立即审查+推进\r\n5. **最多 3 次重试** — 3 次失败后必须换方案\r\n6. **最多 3 次空转** — 3 次空转后必须截断并请求触发词输入\r\n7. **大任务才拆分** — 3步以上输出步骤列表\r\n8. **中断可恢复** — 进度文件保留，重启后 resume\r\n9. **换思路走完整三步** — 禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 快速命令\r\n\r\n```bash\r\n# 进度文件\r\npython {SKILL_DIR}/scripts/task_progress.py init --task \"名称\" --purpose \"目的\" --requirements \"要求\" --risks \"风险\" --steps '[...]'\r\npython {SKILL_DIR}/scripts/task_progress.py update --task \"名称\" --step 1 --status success --review \"...\" --advance \"...\"\r\npython {SKILL_DIR}/scripts/task_progress.py complete --task \"名称\" # --force 跳过步骤检查；--no-enforce 关闭记录校验\r\npython {SKILL_DIR}/scripts/task_progress.py resume --task \"名称\"\r\n\r\n# 问题/风险/经验\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"场景\" --symptom \"症状\" --cause \"原因\" --solution \"方案\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py add-risk --description \"风险\" --impact \"影响\" --mitigation \"缓解\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r\n\r\n# 配置界面\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## 渐进式 MD 文件体系\r\n\r\n| 本文件（SKILL.md）包含 | 拆分到 references/ |\r\n|---|---|\r\n| ✅ 触发条件、核心能力、强制约束总表 | 📄 `mandatory.md` — Phase 0~4 详细规则、模板、禁止行为、空转/重试/换思路流转 |\r\n| ✅ 工作流程概述、循环规则 | 📄 `examples.md` — 完整执行示例（含空转/重试/换思路场景） |\r\n| ✅ 快速命令 | 📄 `reference.md` — 进度文件机制、问题记录、安装、数据目录 |\r\n| | 📄 `antipatterns.md` — 反模式收录（AP-01~AP-08） |\r\n| | 📄 `faq.md` — 常见问题（Q&A 1~12） |\r\n\r\n---\r\n## 版本\r\n当前版本：**5.19.1** — 强制约束总表强制级别标注修正\n\nFile v5.19.1:_meta.json\n\n{\n \"ownerId\": \"kn75zfd51df61ajdyqtgvrs1hx84s4q6\",\n \"slug\": \"triphasic-execution\",\n \"version\": \"5.19.1\",\n \"publishedAt\": 1782383167873\n}\n\nFile v5.19.1:references/antipatterns.md\n\n# Triphasic Execution - 反模式（Antipatterns）\r\n\r\n本文档收录使用本技能时的常见错误和注意事项。\r\n\r\n---\r\n\r\n## 反模式列表\r\n\r\n### ❌ AP-01：跳过语义拆分直接规划\r\n\r\n**错误做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[直接输出任务规划]\r\n```\r\n\r\n**正确做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[首先输出语义拆分]\r\n - 主语：用户\r\n - 目的：修复 bug\r\n - 诉求：定位并修复代码错误\r\n - 动机：恢复功能正常\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-02：跳过审查直接推进\r\n\r\n**错误做法：**\r\n```\r\nEXECUTE → [无 REVIEW] → ADVANCE\r\n```\r\n\r\n**正确做法：**\r\n```\r\nEXECUTE → REVIEW（✅/❌/⚠️ + 证据）→ ADVANCE\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-03：同一步骤无限重试\r\n\r\n**错误做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 重试\r\n第 4 次失败 → 重试（❌ 违反 F-08）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 换方案（✅ 遵守 F-08）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-04：进度文件未创建就执行\r\n\r\n**错误做法：**\r\n```\r\n任务规划 → [无 task_progress.py init] → 直接执行\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务规划 → task_progress.py init → 执行（✅ 遵守 F-03）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-05：任务完成未调用 complete\r\n\r\n**错误做法：**\r\n```\r\n任务执行完 → [无 task_progress.py complete] → 结束\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务执行完 → task_progress.py complete → 输出总结（✅ 遵守 F-09）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-06：中英文混排缺少空格\r\n\r\n**错误做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n**正确做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-07：空转超过 3 次未截断（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n第 1 次空转 → 继续\r\n第 2 次空转 → 继续\r\n第 3 次空转 → 继续\r\n第 4 次空转 → 继续（❌ 违反 F-11）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次空转 → 重述规划，明确要求必须执行\r\n第 2 次空转 → 重述规划，明确要求必须执行\r\n第 3 次空转 → 主动截断，请求用户输入触发词（✅ 遵守 F-11）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-08：换思路时三步骤内部直接循环（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n换思路 → 直接执行新方案（❌ 跳过 REVIEW→ADVANCE）\r\n换思路 → 直接推进（❌ 跳过 EXECUTE→REVIEW）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n换思路 → 原封不动推送到 REVIEW\r\n ↓\r\n REVIEW（记录换思路，不确认执行）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步循环）（✅ 遵守 F-12）\r\n```\r\n\r\n---\r\n\r\n## 注意事项\r\n\r\n1. **语义拆分是强制的** — 收到任务第一个动作必须是语义拆分，不能跳过\r\n2. **规划必须用户确认** — F-02 要求规划输出后需用户确认才能执行\r\n3. **三步循环不可跳过** — Execute→Review→Advance 缺一不可\r\n4. **进度文件必须创建** — F-03 强制要求 init，否则后续 update/complete 会报错\r\n5. **最多 3 次重试** — F-08 强制要求，第 4 次必须换方案\r\n6. **最多 3 次空转** — F-11 强制要求，第 4 次必须截断并请求触发词输入\r\n7. **换思路必须走完整三步** — F-12 强制要求，禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 常见问题排查\r\n\r\n| 问题 | 原因 | 解决方案 |\r\n|------|------|----------|\r\n| `task_progress.py update` 报错 | 未执行 `init` | 先执行 `task_progress.py init` |\r\n| `complete` 校验失败 | 步骤完成率不足 | 检查哪些步骤未标记为 success |\r\n| 重试次数超限 | 同一方案失败 3 次 | 换方案，禁止第 4 次重试 |\r\n| 进度文件丢失 | 误删除或路径错误 | 重新执行 `init`，或手动创建进度文件 |\n\nFile v5.19.1:references/changelog.md\n\n## 5.19.1 (2026-06-09)\r\n\r\n### 修复\r\n- **强制约束总表过时标记**：F-05/F-06/F-08/F-11 的\"Python 强制\"列从\"❌ AI 自觉\"修正为\"✅ 脚本强制/钩子拦截\"\r\n\r\n---\r\n\r\n## 5.19.0 (2026-06-09)\r\n\r\n### 新增\r\n- **P0/P1/P2 钩子系统**：pre_exec_search（执行前 REVIEW 校验）、require_complete_validation（complete 4 项校验）、auto_idle_cutoff（空转≥3 自动 abort）、block_skip_review（跳过 REVIEW 拦截）\r\n- **UI 配置支持完整钩子**：settings.html 新增强制纪律区域，6 个 toggle 开关\r\n- **文本/HTML 配置同步**：save_config_from_json 与 _do_save_config 采用相同 merge 逻辑\r\n\r\n### 改进\r\n- **数据目录规范化**：按 skill-standardization R-12 规范重组标准化目录结构\r\n - data/active/、data/completed/、output/、logs/、temp/、backup/、cache/、state/\r\n- **6 个脚本路径统一**：全部使用 _find_standardization_dir() 计算路径\r\n- **settings.html 移入 assets/**：功能文件与数据目录分离\r\n- **R-12 数据目录锚点补全**：cron_helper.py、exec_wrapper.py、lessons_register.py、problem_daemon.py 补充 DEFAULT_DATA_DIR_RAW\r\n- **R-17 行数合规**：SKILL.md 精简至 230 行\r\n\r\n### 修复\r\n- settings.py R-12 锚点位置错误（import 前引用导致启动失败）\r\n- problem_logger.py R-12 锚点位置错误（同 settings.py）\r\n- settings.html 路径搜索修复（三路 fallback）\r\n- 文档中多处过时路径描述（SKILL.md、reference.md）\r\n- `ttask_progress.py` 拼写错误（6 个文件中 30+ 处）\r\n- changelog 过时规则范围 R-01~R-11 → R-01~R-25\r\n- settings.py 注释占位符 `` → ``\r\n- install.py 交互式提示导致测试工具阻塞\r\n- **三端版本号一致**：SKILL.md / _meta.json / changelog 同步为 5.19.0\r\n\r\n---\r\n\r\n## 5.18.0 (2026-06-09)\r\n\r\n### 改进\r\n- **数据目录规范化**：按 skill-standardization R-12 规范重组标准化目录结构\r\n - data/active/、data/completed/ — 进度文件\r\n - output/ — 记录文件（PROBLEMS.md/RISKS.md/LESSONS_REGISTER.md）\r\n - logs/ — 日志；temp/ — 临时文件；backup/、cache/、state/ — 按规范预留\r\n- **6 个脚本路径统一**：problem_logger、problem_daemon、cron_helper、lessons_register、exec_wrapper、task_progress 全部使用 _find_standardization_dir() 计算路径\r\n- **settings.html 移入 assets/**：功能文件与数据目录分离\r\n\r\n### 新增\r\n- **P2 钩子：auto_idle_cutoff** — 空转≥3 次自动 abort\r\n- **P2 钩子：block_skip_review** — update 时检查上一步 REVIEW\r\n\r\n### 修复\r\n- settings.py R-12 锚点位置错误（import 前引用导致启动失败）\r\n- settings.html 路径搜索修复（三路 fallback）\r\n- 文档中多处过时路径描述（SKILL.md、reference.md）\r\n- **HTML UI 保存后同步更新 SKILL.md**（_do_save_config 补调 update_skill_md）\r\n\r\n---\r\n\r\n\r\n\r\n## v5.18.2 (2026-06-09) — 自动版本升级\r\n\r\n### Changed\r\n- 版本号 5.18.1 → 5.18.2（`update --fix` 自动 bump）\r\n## v5.18.1 (2026-06-09) — 自动版本升级\r\n\r\n### Changed\r\n- 版本号 5.18.0 → 5.18.1（`update --fix` 自动 bump）\r\n## 5.17.3 (2026-05-31)\r\n\r\n### 修复\r\n- **R-04**: description 删除版本号\r\n- **R-06**: H1 删除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n## 5.17.2 (2026-05-30)\r\n\r\n### 修复\r\n- **R-04**: description 删除版本号\r\n- **R-06**: H1 删除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n# triphasic-execution 版本更新日志\r\n## v5.17.0（2026-05-28）\r\n\r\n**改写类型：标准化改造 — 修复 R-11/R-20/R-23 违规**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-11 产出物路径违规：`assets/` 和 `temp_progress/` 迁至 `skills/.standardization/triphasic-execution/data/`\r\n- ✅ 修复 R-20 写作规范：`ttask_progress.py`（双t typo）→ `task_progress.py`；中英文混排补空格\r\n- ✅ 修复 R-22/R-23 文档-代码一致性：`SKILL.md`/`faq.md`/`examples.md`/`reference.md` 路径引用全部修正\r\n- ✅ 新增 frontmatter 字段：`data_dir: ../.standardization/triphasic-execution/`、`external_data_dir: true`\r\n- ✅ `assets/default_config.json` → `data/default_config.json`；`assets/settings.html` → `data/settings.html`\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 0 ERROR 0 WARN（剩余 2 WARN 为审计工具误报，非真实违规）\r\n- 数据目录合规，符合 R-11/R-12/R-22 规范\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## v5.16.0（2026-05-28）\r\n\r\n**改写类型：功能增强 — 规划能力增强 + 执行验证机制 + 强制约束落脚本**\r\n\r\n### 更新内容\r\n\r\n- ✅ 增强语义理解（F-01+）：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），Phase 0 新增注意力锚定、自我反查\r\n- ✅ 增强步骤规划（F-02+）：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），Phase 1 新增规划逻辑说明（非调用链，仅参考逻辑）\r\n- ✅ 新增 F-11：同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，由 `ttask_progress.py --idle` 脚本级强制\r\n- ✅ 新增 F-12：换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环\r\n- ✅ 新增 F-13：推进阶段成功后，坚决不倒回已画√的步骤\r\n- ✅ `ttask_progress.py` 新增字段：`idle_count`、`executed_proof`、`snapshot_before`、`snapshot_after`\r\n- ✅ `ttask_progress.py` 新增子命令：`pre_exec`（执行前文件快照）、`verify_exec`（执行后验证文件变化）\r\n- ✅ `ttask_progress.py` 新增参数：`--idle`、`--verify-execution`、`--proof`、`--clear-cache`、`--trigger-word`\r\n- ✅ `ttask_progress.py` F-08/F-11 强制约束由脚本实现（≥3次 `sys.exit(1)`），不再靠 AI 自觉\r\n- ✅ `_clear_tool_cache()` 清除 `__pycache__`/`.pyc` 等缓存，避免验证误判\r\n- ✅ `mandatory.md` Phase 2~4 新增完整空转/重试/换思路/求助流转规则\r\n- ✅ `antipatterns.md` 新增 AP-07（空转超3次未截断）、AP-08（换思路时三步骤内部直接循环）\r\n- ✅ `faq.md` 新增 Q11（什么是空转）、Q12（换思路为什么要走完整三步循环）\r\n- ✅ 修复 `_meta.json` 版本号描述拼写错误\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计预期 0 ERROR 0 WARN\r\n- 空转/重试约束从\"AI 自觉\"升级为\"脚本强制\"\r\n- 执行验证支持文件系统级证据（mtime + hash 对比）\r\n\r\n---\r\n\r\n## v5.15.0（2026-05-25）\r\n\r\n**改写类型：Bug 修复 — R-20 术语不一致 + 中英文混排 + 拼写错误**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-20 术语不一致（\"配置\" → \"配置\"、\"更新\" → \"更新\"）\r\n- ✅ 修复 R-20 中英文混排缺少空格（\"Bug\" → \"Bug \"、\"Token\" → \"Token \" 等）\r\n- ✅ 修复拼写错误（`tAsk_progress.py` → `ttask_progress.py`）\r\n- ✅ 修复 `## 核心能力` 章节渐进式加载说明（通过 R-21 检查）\r\n- ✅ 修复触发条件否定条件（添加单步任务不触发的说明）\r\n- 📦 更新 `_meta.json` 和 `SKILL.md` 版本号至 v5.15.0\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 21/21 PASS（0 ERROR）\r\n- R-20 写作规范全面符合\r\n- 渐进式加载说明显式化\r\n\r\n---\r\n\r\n## v5.14.0（2026-05-24）\r\n\r\n**改写类型：skill-standardization refactor 正确改造**\r\n\r\n### 更新内容\r\n- ✅ 使用 `refactor` 模式正确改造（先 `--dry-run` 再实际执行）\r\n- ✅ 自动备份：`triphasic-execution_bak_refactor_20260524_230726`\r\n- ✅ 调用 `permission_checker.py` 扫描脚本权限（8 文件 / 3219 行）\r\n- ✅ 权限扫描结果：风险等级 MEDIUM，权重 50%，28 个问题（27 HIGH + 1 MEDIUM）\r\n- ✅ 生成 `references/permission.md`（基于扫描报告，非手写）\r\n- ✅ 生成 `references/permission_report.json`（机器可读）\r\n\r\n### 权限扫描摘要\r\n| 权限类型 | 次数 |\r\n|---------|------|\r\n| `subprocess_call` | 21 |\r\n| `file_delete` | 6 |\r\n| `network_access` | 1 |\r\n| `sensitive_access` | 0 |\r\n| `critical_write` | 0 |\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=16（全规则通过）\r\n\r\n---\r\n\r\n## v5.10.1（2026-05-23）\r\n\r\n**改写类型：skill-standardization 标准化审查**\r\n\r\n### 更新内容\r\n- 标准化审查通过，无需更新（R-01~R-25 全部合规）\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=5\r\n\r\n---\r\n\r\n## 版本历史\r\n\r\n> 详细版本历史参见 git 提交记录。\r\n> 标准化审查前的版本信息由 SKILL.md frontmatter `version` 和 git tag 追溯。\n\nFile v5.19.1:references/examples.md\n\n# examples.md — 完整执行流程示例\r\n\r\n> 本文件包含 triphasic-execution 的完整示例，供参考学习时加载。\r\n\r\n---\r\n\r\n## 示例：多步任务（标准完整流程）\r\n\r\n```\r\n用户：请帮我修复登录接口 Bug\r\n\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n\r\n[自检] 当前阶段：收到任务\r\n- F-01 语义拆分：待执行\r\n- F-02 任务规划：待执行\r\n违规项：无，执行语义拆分\r\n\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n请帮我修复登录接口 Bug\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：用户\r\n 角色：requester\r\n 目的：登录接口恢复正常\r\n 诉求：\r\n 1. 修复登录接口中的 Bug\r\n 动机：当前登录功能存在问题\r\n\r\n## 块 2：执行者\r\n 角色：executor\r\n 目的：定位并修复登录接口 Bug\r\n 诉求：\r\n 1. 读取代码定位问题\r\n 2. 修复代码\r\n 3. 验证修复有效\r\n 动机：块1的所有要求\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n\r\n【任务规划】修复登录接口 Bug\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞\r\n📋 具体要求：添加 Token 验证逻辑，确保未携带有效 Token 的请求被拒绝\r\n⚠️ 潜在风险：更新可能影响正常登录流程\r\n\r\n**执行步骤**：\r\n 步骤 1: 读取登录接口代码\r\n - 任务目的：获取当前代码，理解认证逻辑现状\r\n - 工具/命令：`Read`\r\n - 操作说明：读取 login.py 文件\r\n - 预期结果：获取完整代码内容\r\n - 潜在风险：文件不存在\r\n\r\n 步骤 2: 修复代码\r\n - 任务目的：添加缺失的 Token 验证逻辑\r\n - 工具/命令：`Edit`\r\n - 操作说明：在指定位置添加验证逻辑\r\n - 预期结果：代码更新成功，无语法错误\r\n - 潜在风险：语法错误、引入新 bug\r\n\r\n 步骤 3: 测试验证\r\n - 任务目的：验证修复有效且未影响正常功能\r\n - 工具/命令：`Bash`（pytest）\r\n - 操作说明：运行测试用例\r\n - 预期结果：测试通过\r\n - 潜在风险：测试环境问题\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]：\r\n → 问题记录 → 风险记录 → 经验积累\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r\n\r\n→ [MANDATORY-F-03] 创建进度文件：\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"修复登录 Bug\" \\\r\n --purpose \"修复 Token 验证缺失导致的认证绕过漏洞\" \\\r\n --requirements \"添加 Token 验证逻辑\" \\\r\n --risks \"可能影响正常登录\" \\\r\n --steps '[{\"description\":\"读取代码\",\"purpose\":\"理解认证逻辑\",\"tool\":\"Read\"},{\"description\":\"修复代码\",\"purpose\":\"添加验证\",\"tool\":\"Edit\"},{\"description\":\"测试验证\",\"purpose\":\"确认修复有效\",\"tool\":\"Bash\"}]'\r\n\r\n### 🔧 [EXECUTE] - 步骤 1\r\n🔧 执行前重述目的：获取当前代码，理解认证逻辑现状\r\n（读取 login.py...）\r\n\r\n### 🔍 [REVIEW] - 步骤 1\r\n✅成功 -- 发现 Token 验证逻辑缺失\r\n\r\n### 📍 [ADVANCE] - 步骤 1\r\n推进：继续步骤 2\r\n→ 更新进度文件：python {SKILL_DIR}/scripts/task_progress.py update --task \"修复登录 Bug\" --step 1 --status success --review \"发现 Token 验证缺失\" --advance \"继续步骤2\"\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：1/3（33%）▸ 下一：步骤2\r\n\r\n...（继续步骤 2-3）\r\n\r\n【任务完成】\r\n- 目标：修复登录接口 Bug\r\n- 结果：✅成功 -- Token 验证已添加\r\n- 进度：3/3（100%）\r\n→ [MANDATORY-F-09] python {SKILL_DIR}/scripts/task_progress.py complete --task \"修复登录 Bug\"\r\n```\n\nFile v5.19.1:references/faq.md\n\n# Triphasic Execution - 常见问题（FAQ）\r\n\r\n本文档收录使用本技能时的常见问题和解答。\r\n\r\n---\r\n\r\n## Q&A 列表\r\n\r\n### Q1：什么时候应该使用 triphasic-execution？\r\n\r\n**A：** 当任务满足以下任一条件时：\r\n- 多步骤任务（≥3 步）\r\n- 容易出现死循环或无限重试\r\n- 需要中断恢复能力\r\n- 需要结构化的问题/风险/经验记录\r\n\r\n**不适合的场景：**\r\n- 简单问答（单步即可完成）\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n- 用户明确要求不使用本技能\r\n\r\n---\r\n\r\n### Q2：语义拆分是什么？为什么要强制？\r\n\r\n**A：** 语义拆分是将用户任务拆解为结构化字段：\r\n- **主语**：谁发起的任务\r\n- **目的**：为什么要做这个任务\r\n- **诉求**：具体要做什么\r\n- **动机**：深层需求是什么\r\n\r\n**强制原因：** 防止 AI 误解任务意图，导致执行方向错误。\r\n\r\n---\r\n\r\n### Q3：F-02 要求规划必须用户确认，能不能跳过？\r\n\r\n**A：** 不能。F-02 是强制约束（用 ❌ AI 自觉 标记），必须输出规划并等待用户确认后才能执行。\r\n\r\n**例外：** 如果用户明确说\"直接执行\"、\"不需要确认\"，可以跳过，但需要在规划中说明。\r\n\r\n---\r\n\r\n### Q4：task_progress.py 有什么用？不用行不行？\r\n\r\n**A：** `task_progress.py` 用于持久化进度，支持中断恢复。F-03 强制要求调用 `init`，F-07 强制要求每步调用 `update`，F-09 强制要求任务完成时调用 `complete`。\r\n\r\n**不用的后果：**\r\n- 任务中断后无法恢复\r\n- 无法追踪步骤完成率\r\n- `complete` 校验会失败（v5.12+）\r\n\r\n---\r\n\r\n### Q5：同一步骤失败 3 次后必须换方案，能不能第 4 次重试？\r\n\r\n**A：** 不能。F-08 是强制约束，第 4 次重试违反规范。\r\n\r\n**正确做法：**\r\n- 第 1~3 次：尝试同一方案\r\n- 第 3 次失败后：换方案（完全不同思路）\r\n- 新方案再失败：继续换，直到任务完成或所有方案耗尽\r\n\r\n---\r\n\r\n### Q6：`complete` 校验失败怎么办？\r\n\r\n**A：** `complete` 校验检查以下内容：\r\n1. 步骤完成率（所有步骤必须标记为 success）\r\n2. 记录文件（PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md）\r\n3. summary.json（任务总结）\r\n\r\n**修复方法：**\r\n- 完成所有未完成的步骤\r\n- 运行 `problem_logger.py add` 记录问题/风险\r\n- 运行 `task_progress.py complete --force` 跳过步骤检查（不推荐）\r\n- 运行 `task_progress.py complete --no-enforce` 关闭记录校验（不推荐）\r\n\r\n---\r\n\r\n### Q7：按需调用模式和全局自动模式有什么区别？\r\n\r\n**A：**\r\n- **按需调用（默认）**：用户说出关键词（\"三步执行\"、\"triphasic\"等）才触发\r\n- **全局自动模式**：所有任务自动套用框架，无需关键词\r\n\r\n**切换方法：**\r\n编辑 `data/default_config.json` → `\"mode\": \"auto\"`\r\n\r\n---\r\n\r\n### Q8：settings.py 是干什么的？\r\n\r\n**A：** `settings.py` 是一个 HTML 可视化配置界面，用于配置技能参数（如模式、重试次数、记录文件路径等）。\r\n\r\n**运行方法：**\r\n```bash\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n### Q9：SKILL_DIR 是什么？为什么代码块里用这个变量？\r\n\r\n**A：** `SKILL_DIR` 是一个变量，表示技能安装目录（如 `~/.workbuddy/skills/triphasic-execution`）。\r\n\r\n**为什么用变量：** SKILL.md 是模板文件，实际路径由 AI 根据环境替换。\r\n\r\n**人工阅读时：** 看到 `{SKILL_DIR}` 请自动替换为实际路径。\r\n\r\n---\r\n\r\n### Q10：为什么我的任务被阻断了？\r\n\r\n**A：** 可能被以下约束阻断：\r\n- **F-01**：未输出语义拆分\r\n- **F-02**：未输出任务规划\r\n- **F-03**：未调用 `task_progress.py init`\r\n- **F-07**：未调用 `task_progress.py update`\r\n- **F-08**：同一步骤失败 3 次未换方案\r\n- **F-09**：未调用 `task_progress.py complete`\r\n\r\n**解决方法：** 检查 [自检指令] 输出，看哪个 F-XX 未通过。\r\n\r\n---\r\n\r\n### Q11：什么是\"空转\"？空转 3 次截断是什么意思？（v5.16.0 新增）\r\n\r\n**A：** 空转指 EXECUTE 阶段没有实际执行任何操作（仅输出描述、未调用工具），却进入了 REVIEW 阶段。\r\n\r\n**空转计数规则：**\r\n- 每次 EXECUTE 阶段未实际执行 → 空转计数 +1\r\n- 空转计数 ≤3 次 → 重述规划，明确要求必须执行\r\n- 空转计数 >3 次 → 主动截断，请求用户输入固定触发词打破空转\r\n\r\n**触发词：** `继续执行`（用户可自定义，见配置）\r\n\r\n---\r\n\r\n### Q12：换思路时为什么要走完整三步循环？（v5.16.0 新增）\r\n\r\n**A：** 换思路时如果直接执行或直接推进，会跳过 REVIEW 或 EXECUTE，导致三步循环断裂，属于违反 F-12。\r\n\r\n**正确流转：**\r\n```\r\n换思路产生 → 原封不动推送到 REVIEW（不确认执行）\r\n ↓\r\n REVIEW（记录换思路）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步）\r\n```\r\n\r\n**核心原则：** 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考。没有任何三步骤内部直接循环的情况。\r\n\r\n---\r\n\r\n## 其他问题\r\n\r\n如果这里没有你的问题，请运行：\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"文档\" --symptom \"FAQ 缺少问题 XXX\" --cause \"未收录\" --solution \"补充到 faq.md\"\r\n```\n\nFile v5.19.1:references/mandatory.md\n\n# mandatory.md — 强制约束详细规则\r\n\r\n> 本文件包含 triphasic-execution 的完整强制约束内容，供需要深入了解规则细节时加载。\r\n\r\n---\r\n\r\n## Phase 0 —— 语义拆分完整规则（增强版 v5.16.0）\r\n\r\n> **违反 F-01：如果 AI 没有输出语义拆分就开始规划或执行，属于严重违规。必须回滚并先输出拆分结果。**\r\n> **v5.16.0 增强**：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力。\r\n\r\n### 拆分规则（增强版）\r\n\r\n**块（Block）识别**：按主语划分，每个主语构成一个块。\r\n\r\n| 主语类型 | 识别方式 |\r\n|---------|---------|\r\n| 用户（\"我\"） | 说话者本人 |\r\n| AI 助手（\"你\"） | 执行者、帮助者 |\r\n| 第三方（\"他/她/它\"） | 提及的其他角色 |\r\n\r\n**每个块提取三类信息：**\r\n\r\n| 元素 | 定义 | 增强标注 |\r\n|-----|------|---------|\r\n| **目的** | 最终要达成的目标 | 标注🔴🟡⚪约束强度 |\r\n| **诉求** | 需要执行的具体操作或交付物 | 硬约束🔴/软约束🟡/无约束⚪ |\r\n| **动机** | 为什么会产生这个需求 | 背景/原因/情绪 |\r\n\r\n### v5.16.0 新增：5W2H 维度提取（参考 semantic-split）\r\n\r\n**步骤 0.5**：任务类型识别与 5W2H 初始化（内部执行，不输出）\r\n\r\n1. **任务类型识别**：制作PPT / 填写周报 / 安排行程 / 写邮件 / 策划活动 / 其他\r\n2. **5W2H 维度初始化**：按任务类型从默认映射表填入默认值\r\n3. **约束强度预标注**：🔴硬约束 / 🟡软约束 / ⚪无约束\r\n\r\n**步骤 0.7**：注意力锚定（内部执行，不输出）\r\n\r\n1. `[CRITICAL]` — 硬约束，后续不可违反\r\n2. `[CORE]` — 核心目标（动词+宾语）\r\n3. `[ENTITY]` — 数字、时间、人名\r\n4. `[EXAMPLE]` — 举例内容，降权不作为约束\r\n5. `[RESISTANCE]` — 「但是/担心/难」后内容\r\n6. 核心句重构：「[主语] 要 [CORE] 于 [时间/场景]」（≤20字）\r\n\r\n### v5.16.0 新增：自我反查（内部执行，不输出）\r\n\r\n| 反查 | 检查内容 | 修正 |\r\n|------|---------|------|\r\n| 1 | 硬约束遗漏：`[CRITICAL]` 是否全在结果中？ | 补充 |\r\n| 2 | 约束误判：🟡 词被标为 🔴？ | 修正 |\r\n| 2b | 隐式升级：🟡 约束属组织规范/法律/安全？→ 🟡🔴 或 🔴 | 升级 |\r\n| 3 | 举例干扰：`[EXAMPLE]` 被当核心诉求？ | 降级 |\r\n| 4 | 5W2H 缺失：有明显可推断维度？ | 补充 `[推断]` |\r\n\r\n### 输出格式（[MANDATORY] 必须按此格式输出）\r\n\r\n```\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n[用户原话完整引用]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：[主语名称]\r\n 角色：[用户/执行者/第三方]\r\n 目的：[该主语要达成的核心目标] 🔴/🟡/⚪\r\n 诉求：\r\n 1. [诉求点1] 🔴/🟡/⚪\r\n 2. [诉求点2] 🔴/🟡/⚪\r\n 3. [诉求点3] 🔴/🟡/⚪\r\n 动机：[产生该需求的背景/原因/情绪]\r\n\r\n## 块 2：[主语名称]\r\n 角色：[执行者]\r\n 目的：[执行者要达成的目标]\r\n 诉求：\r\n 1. [需要执行的行为1]\r\n 2. [需要执行的行为2]\r\n 动机：[块1的所有要求]\r\n\r\n**5W2H 维度**：\r\n - Why（为什么）：[值] 🔴/🟡/⚪\r\n - What（做什么）：[值] 🔴/🟡/⚪\r\n - Who（谁参与）：[值] 🔴/🟡/⚪\r\n - Where（在哪里）：[值] 🔴/🟡/⚪\r\n - When（什么时候）：[值] 🔴/🟡/⚪\r\n - How（怎么做）：[值] 🔴/🟡/⚪\r\n - How much（多少）：[值] 🔴/🟡/⚪\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n```\r\n\r\n---\r\n\r\n## Phase 1 —— 任务规划完整模板（增强版 v5.16.0）\r\n\r\n> **违反 F-02：如果 AI 在输出【语义拆分】后没有输出【任务规划】就开始执行，属于严重违规。**\r\n> **v5.16.0 增强**：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）。\r\n\r\n### 判断流程（增强版）\r\n\r\n```\r\n收到任务\r\n │\r\n ├─ [MANDATORY] 第零步：语义拆分（F-01，必做）[增强：5W2H + 约束标注]\r\n │ → 输出块分析：主语/目的/诉求/动机 + 5W2H维度 + 约束强度\r\n │\r\n ├─ [MANDATORY] 第一步：任务规划（F-02，必做，所有任务）[增强：参考skill-sub规划逻辑]\r\n │ → 明确：任务目的、具体要求、使用工具、预期结果、潜在风险\r\n │ → [增强] 步骤排序（参考skill-sub的意图理解→步骤排序逻辑）\r\n │ → [增强] 执行计划生成（参考skill-sub的执行计划生成逻辑）\r\n │\r\n ├─ 第二步：判断是否需要拆分\r\n │ ├─ 单步任务（1个操作可完成）→ 直接进入执行\r\n │ └─ 多步任务（2个以上操作）→ 任务拆分，列出子步骤\r\n │\r\n ├─ [MANDATORY] 第三步：创建进度文件（F-03，规划确认后立即执行）\r\n │ → 调用 task_progress.py init\r\n │\r\n └─ 第四步：进入 Execute→Review→Advance 循环\r\n```\r\n\r\n### v5.16.0 新增：参考 skill-sub 的规划逻辑（非调用链）\r\n\r\n**意图理解**（参考 skill-sub 的\"理解意图\"阶段）：\r\n- 分析用户输入，判断任务类型\r\n- 识别核心目标与约束条件\r\n- 输出：任务意图摘要\r\n\r\n**步骤排序**（参考 skill-sub 的\"规划技能顺序\"阶段）：\r\n- 推荐参与的工具/命令及其顺序\r\n- 标记步骤依赖关系\r\n- 输出：步骤顺序列表（含并行/串行标记）\r\n\r\n**执行计划生成**（参考 skill-sub 的\"生成执行计划\"阶段）：\r\n- 输出 AI 可直接执行的指令序列\r\n- 含并行/串行标记、里程碑位置\r\n- 输出：执行计划（非调用链JSON，仅为步骤描述）\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**步骤排序**（参考 skill-sub 规划逻辑）：\r\n 步骤 N: [操作描述] ── serial/parallel ── depends_on: [依赖]\r\n constraint_level: 🔴/🟡/⚪\r\n\r\n**执行计划**（参考 skill-sub 执行计划生成逻辑）：\r\n 1. [具体操作1]\r\n 2. [具体操作2]\r\n ...\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n**请确认执行（输入选项，调整请同时说明要求）**：\r\n1. 执行全部（包括问题/风险/经验记录）\r\n2. 执行但跳过问题/风险/经验记录\r\n3. 取消任务\r\n4. 调整任务\r\n\r\n请输入：\r\n```\r\n\r\n### 任务拆分模板（仅大任务，3步以上）\r\n\r\n```\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 步骤 2: [操作描述]\r\n ...\r\n\r\n**步骤排序**（参考 skill-sub）：\r\n 步骤 1 ── serial ── milestone: ✅/❌\r\n 步骤 2 🟡: [名称]（增强：来自发散方案）\r\n ⚠️ 风险：[说明]（如涉及🔴突破）\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]（必须执行，除非用户明确跳过）：\r\n → 问题记录：回顾执行过程，识别问题 → 调用 add\r\n → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r\n → 经验积累：执行完成后 → 调用 merge-to-lessons\r\n\r\n**临时进度文件**：规划确认后立即创建（F-03），每步更新（F-07），完成后删除（F-09）\r\n```\r\n\r\n---\r\n\r\n## Phase 2~4 —— 执行/审查/推进循环详细规则（增强版 v5.16.0）\r\n\r\n### [MANDATORY] EXECUTE 阶段规则\r\n\r\n> **违反 F-04：如果 AI 执行步骤前没有重述本步骤任务目的，属于违规。**\r\n> **v5.16.0 增强**：明确空转计数规则。\r\n\r\n- **[MANDATORY]** 执行前必须输出：`🔧 执行前重述目的：[本步骤目的]`\r\n- 实际运行命令、调用工具、测试代码\r\n- 只跑一个主要命令（可并行多个独立命令）\r\n- 不提前分析结果，不跳到审查阶段\r\n- **[v5.16.0 新增]** 空转判断：如果执行阶段没有实际执行任何操作（仅输出描述、未调用工具），则视为空转，空转计数+1\r\n\r\n### [MANDATORY] REVIEW 阶段规则\r\n\r\n> **违反 F-05：如果 AI 执行步骤后没有输出 REVIEW，属于违规，不得继续执行下一步。**\r\n> **v5.16.0 增强**：明确空转计数、重试计数、换思路到达的处理规则。\r\n\r\n- **[MANDATORY]** 执行后必须紧跟 REVIEW，给出明确判断：✅成功 / ❌失败 / ⚠️部分\r\n- 列出具体证据（数据、错误码、状态）\r\n- **[MANDATORY]** 对照任务目的判断是否达成\r\n- 不执行新操作\r\n- **[v5.16.0 新增]** 空转未执行 → 空转计数+1，不画√\r\n- **[v5.16.0 新增]** 重试失败 → 重试计数+1\r\n- **[v5.16.0 新增]** 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n\r\n### [MANDATORY] ADVANCE 阶段规则\r\n\r\n> **违反 F-06：如果 AI REVIEW 后没有输出 ADVANCE，属于违规，不得跳到下一步。**\r\n> **v5.16.0 增强**：明确成功/失败/空转/换思路的完整流转规则，禁止三步骤内部直接循环。\r\n\r\n- **[MANDATORY]** REVIEW 后必须紧跟 ADVANCE，明确：继续 / 换方向 / 结束 / 向上返回\r\n- **[MANDATORY]** 更新进度追踪表，标记当前步骤状态\r\n- **[MANDATORY]** 调用 `task_progress.py update` 持久化进度（F-07）\r\n- 不直接执行，只规划\r\n- **[v5.16.0 新增]** 成功：根据步骤确定接下来要执行什么，推进执行；**坚决不倒回已画√的步骤**\r\n- **[v5.16.0 新增]** 失败：根据重试次数明确重试 或 换思路 或 求助\r\n- **[v5.16.0 新增]** 空转：重述之前规划并告知执行必须执行 或 主动截断\r\n- **[v5.16.0 新增]** 换思路：原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n\r\n### v5.16.0 新增：空转/重试/换思路/求助 完整流转规则\r\n\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n#### 执行阶段（EXECUTE）流转规则\r\n\r\n```\r\n执行阶段（EXECUTE）\r\n ├─ 实际执行成功 → 进入 REVIEW\r\n ├─ 实际执行失败 → 重试计数+1\r\n │ ├─ 重试≤3次 → 继续重试执行\r\n │ └─ 重试>3次 → 换思路 或 求助用户\r\n ├─ 空转（未实际执行）→ 空转计数+1\r\n │ ├─ 空转≤3次 → 重述规划，明确要求必须执行\r\n │ └─ 空转>3次 → 主动截断，请求用户输入固定触发词打破空转\r\n └─ 换思路 → 原封不动推送到 REVIEW（不确认执行）\r\n```\r\n\r\n#### 审查阶段（REVIEW）流转规则\r\n\r\n```\r\n审查阶段（REVIEW）\r\n ├─ 确认上一步执行逻辑无误 → 步骤画√（✅）\r\n ├─ 空转未执行 → 空转计数+1，不画√\r\n ├─ 重试失败 → 重试计数+1\r\n ├─ 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n └─ 导入分支结果 → 记录成功或失败\r\n```\r\n\r\n#### 推进阶段（ADVANCE）流转规则\r\n\r\n```\r\n推进阶段（ADVANCE）\r\n ├─ 成功 → 根据步骤确定接下来要执行什么，推进执行；坚决不倒回已画√的步骤\r\n ├─ 失败 → 根据重试次数明确重试 或 换思路 或 求助\r\n │ ├─ 重试次数<3 → 推进重试执行\r\n │ ├─ 重试次数≥3 → 换思路 或 求助用户\r\n │ └─ 求助 → 明确发出交互请求，主动截断并等待用户输入\r\n ├─ 换思路 → 原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n │ → 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考\r\n │ → 没有任何三步骤内部直接循环的情况，每一步都是最小单元，不能自循环闭环\r\n └─ 空转 → 重述之前规划并告知执行必须执行 或 主动截断\r\n ├─ 空转次数<3 → 重述之前规划并告知执行必须执行，返回 EXECUTE\r\n └─ 空转次数≥3 → 主动截断，请求用户输入固定触发词打破空转，停止并发出交互请求\r\n```\r\n\r\n#### 固定触发词打破空转规则\r\n\r\n> **v5.16.0 新增**：当空转次数≥3次时，AI 必须主动截断当前流程，请求用户输入固定触发词来重新激发执行。\r\n\r\n**触发词**：`继续执行`（用户可自定义，见配置）\r\n\r\n**截断后行为**：\r\n1. AI 输出：`⚠️ 空转次数已达到3次，主动截断。请输入触发词\"继续执行\"以重新激发执行。`\r\n2. AI 停止当前执行循环，等待用户输入\r\n3. 用户输入触发词后，AI 重新进入 EXECUTE 阶段，重置空转计数（可选），继续执行\r\n\r\n#### 求助规则\r\n\r\n> **v5.16.0 新增**：当超出重试或空转次数时，AI 必须明确发出交互请求，主动截断并等待用户输入。\r\n\r\n**触发条件**：\r\n- 同一步骤失败，重试次数≥3次\r\n- 同一步骤空转次数≥3次\r\n- 换思路后仍无法继续执行\r\n\r\n**求助输出格式**：\r\n```\r\n⚠️ 求助请求\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n**问题描述**：[描述当前遇到的问题，为什么无法继续]\r\n\r\n**已尝试方案**：\r\n 1. [方案1]（失败原因）\r\n 2. [方案2]（失败原因）\r\n 3. [方案3]（失败原因）\r\n\r\n**需要帮助的内容**：\r\n - [具体问题1]\r\n - [具体问题2]\r\n\r\n**建议下一步**：\r\n - [建议1]\r\n - [建议2]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n请提供指导或输入触发词\"继续执行\"以继续。\r\n```\r\n\r\n### 执行输出标准格式\r\n\r\n```\r\n### 🔧 [EXECUTE] - 步骤 N\r\n🔧 执行前重述目的：[本步骤任务目的]\r\n（执行操作...）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 🔍 [REVIEW] - 步骤 N\r\n[✅成功/❌失败/⚠️部分] -- [具体证据]\r\n→ [v5.16.0 新增] 重试计数：N（若失败，则+1）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 📍 [ADVANCE] - 步骤 N\r\n推进：[继续步骤 N+1 / 重试 / 换方案 / 任务完成 / 求助]\r\n→ [v5.16.0 新增] 若换思路：原封不动推送到 REVIEW（不确认执行）\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ N │ ... │ ... │ ... │ ... │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：N/Total（X%）▸ 下一：步骤 N+1\r\n```\r\n\r\n### 状态标记规则\r\n\r\n| 标记 | 含义 | 说明 |\r\n|------|------|------|\r\n| ⏳ | 待执行 | 初始状态 |\r\n| 🔄 | 执行中 | 正在执行 |\r\n| ✅ | 成功 | 审查通过 |\r\n| ❌ | 失败 | 需要重试或换方案 |\r\n| ⏭️ | 跳过 | 经评估无需执行 |\r\n| 🔁 | 重试中 | 正在重试（重试计数 由 `permission_checker.py` 扫描生成（2026-05-24），扫描 8 个文件、3219 行。\r\n\r\n## 扫描结果摘要\r\n\r\n| 项目 | 值 |\r\n|------|-----|\r\n| 风险等级 | **MEDIUM** |\r\n| 权限权重 | **50.00%** |\r\n| 扫描文件数 | 8 |\r\n| 扫描行数 | 3219 |\r\n| 问题总数 | 28 |\r\n\r\n## 权限统计\r\n\r\n| 权限类型 | 次数 | 权重 |\r\n|---------|------|------|\r\n| `sensitive_access` | 0 | 40% |\r\n| `critical_write` | 0 | 30% |\r\n| `network_access` | 1 | 20% |\r\n| `file_delete` | 6 | 10% |\r\n| `subprocess_call` | 21 | — |\r\n\r\n## 高权限操作清单\r\n\r\n### subprocess_call（21 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/cron_helper.py` | 17, 43 | `subprocess` | `immediate` |\r\n| `scripts/exec_wrapper.py` | 32, 167, 180, 187, 195 | `subprocess` | `immediate` |\r\n| `scripts/install.py` | 85, 88, 126, 214 | `subprocess` / `exec(` | `immediate` |\r\n| `scripts/lessons_register.py` | 18, 60, 83 | `subprocess` | `immediate` |\r\n| `scripts/problem_daemon.py` | 27, 160, 413, 416, 417, 439 | `subprocess` / `Popen` | `immediate` |\r\n\r\n### file_delete（6 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/install.py` | 76, 189 | `shutil.rmtree` | `immediate` |\r\n| `scripts/task_progress.py` | 439, 443, 496, 501 | `os.remove` | `immediate` |\r\n\r\n### network_access（1 处，MEDIUM）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/settings.py` | 25 | `urllib` | `unified` |\r\n\r\n## 授权方式说明\r\n\r\n| 方式 | 适用场景 | 说明 |\r\n|------|----------|------|\r\n| `unified` | 中风险操作（network_access） | 批量统一授权，首次确认后可复用 |\r\n| `immediate` | 高风险操作（subprocess_call、file_delete） | 每次执行前需用户确认 |\r\n| `silent` | 低风险操作 | 无需授权，静默执行 |\r\n\r\n## 风险结论\r\n\r\n- **风险等级：MEDIUM**（权重 50%）\r\n- **建议**：高权限操作（subprocess、文件删除）已标注 `immediate` 授权方式，符合规范；网络访问（`settings.py`）使用 `unified` 授权，符合规范。\r\n- **R-15 检查**：所有高权限操作前均应有授权检查逻辑。\n\nFile v5.19.1:references/reference.md\n\n# reference.md — CLI 命令速查、进度文件、问题记录、数据目录、安装\r\n\r\n> 本文件包含 triphasic-execution 的完整命令参考和配置说明，供需要时加载。\r\n\r\n---\r\n\r\n## 临时进度文件机制\r\n\r\n> **[MANDATORY]** 违反 F-03/F-07/F-09 属于严重违规。\r\n\r\n### 核心原理\r\n\r\n```\r\n任务规划确认\r\n └─→ [MANDATORY] 创建临时进度文件（init）\r\n │\r\n ├─ 步骤1 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n ├─ 步骤2 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n │ ...\r\n └─ 任务完成 → [MANDATORY] 删除进度文件（complete）\r\n 中断/异常 → 保留文件，下次 resume 恢复\r\n```\r\n\r\n### AI 调用时机（[MANDATORY]）\r\n\r\n| 时机 | 必须调用的命令 |\r\n|------|----------------|\r\n| 任务规划确认后 | `init` |\r\n| 每个步骤 ADVANCE 后 | `update --step N --status success/failed --review \"...\" --advance \"...\"` |\r\n| 任务全部完成后 | `complete` |\r\n| 用户说\"继续\"、\"恢复\" | `resume` |\r\n| 用户说\"取消任务\"、\"停止\" | `abort --reason \"...\"` |\r\n\r\n### 命令速查\r\n\r\n```bash\r\n# [MANDATORY] 初始化（任务规划确认后立即调用）\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"任务名\" \\\r\n --purpose \"任务目的\" \\\r\n --requirements \"具体要求\" \\\r\n --risks \"潜在风险\" \\\r\n --steps '[{\"description\":\"步骤描述\",\"purpose\":\"步骤目的\",\"tool\":\"工具名\"}]'\r\n\r\n# [MANDATORY] 更新步骤状态（每步 ADVANCE 后调用）\r\npython {SKILL_DIR}/scripts/task_progress.py update \\\r\n --task \"任务名\" \\\r\n --step 1 \\\r\n --status success \\\r\n --review \"审查结论\" \\\r\n --advance \"推进决策\"\r\n\r\n# 恢复中断任务\r\npython {SKILL_DIR}/scripts/task_progress.py resume --task \"任务名\"\r\n\r\n# [MANDATORY] 完成任务（删除进度文件）\r\npython {SKILL_DIR}/scripts/task_progress.py complete --task \"任务名\"\r\n\r\n# 中止任务\r\npython {SKILL_DIR}/scripts/task_progress.py abort --task \"任务名\" --reason \"原因\"\r\n\r\n# 列出活跃任务\r\npython {SKILL_DIR}/scripts/task_progress.py list\r\n\r\n# 清理已完成/中止文件\r\npython {SKILL_DIR}/scripts/task_progress.py clean\r\n```\r\n\r\n---\r\n\r\n## 问题、风险、经验记录\r\n\r\n### [MANDATORY] 强制记录规则\r\n\r\n> 每次任务执行完成后，**[MANDATORY]** AI 必须执行以下步骤（除非用户明确选择\"2.跳过记录\"）：\r\n> 1. 回顾执行过程，识别问题 → 调用 `add`\r\n> 2. 回顾执行过程，识别风险 → 调用 `add-risk`\r\n> 3. 执行完成后 → 调用 `merge-to-lessons`\r\n\r\n### 问题记录\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add \\\r\n --scene \"API 测试\" \\\r\n --symptom \"HTTP 503\" \\\r\n --cause \"服务端限流\" \\\r\n --solution \"增加重试机制\" \\\r\n --task \"用户头像接口\"\r\n```\r\n\r\n### 风险记录\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add-risk \\\r\n --description \"网络不稳定可能导致 API 调用失败\" \\\r\n --impact \"用户体验下降\" \\\r\n --mitigation \"增加重试机制和降级策略\" \\\r\n --task \"用户头像接口\"\r\n```\r\n\r\n### 经验积累\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r\n```\r\n\r\n---\r\n\r\n## 配置界面\r\n\r\n安装技能后首次运行 `install.py` 时，会自动弹出 HTML 配置界面（系统默认浏览器），引导用户完成初始配置。\r\n\r\n| 配置项 | 选项 | 说明 |\r\n|---|---|---|\r\n| **默认调用方式** | 调用模式（按需） / 全局模式 | 控制技能激活方式 |\r\n| **记录文件路径** | TRIPHASIC_HOME 等 | 未自定义时使用默认值 |\r\n| **任务规划确认** | 询问确认后再执行 / 直接执行 | 控制 Agent 是否请求确认 |\r\n\r\n**当前配置**：\r\n> **调用方式**：🟢 按需调用模式（默认）\r\n> **数据目录**：`skills/.standardization/triphasic-execution/data/`\r\n> **任务规划确认**：询问确认后再执行\r\n\r\n呼出配置界面：向 Agent 发送\"打开 triphasic 配置\"，或运行 `python {SKILL_DIR}/scripts/settings.py`\r\n\r\n---\r\n\r\n## 双模式设计\r\n\r\n| 维度 | 按需调用模式（默认） | 全局自动模式（可选） |\r\n|---|---|---|\r\n| **触发条件** | 用户主动加载技能 | 配置 `mode: global` + 启动 daemon |\r\n| **记录行为** | 调用时才记录三步框架 | 所有任务自动应用三步框架 |\r\n| **后台守护** | 不启动 daemon | `problem_daemon.py` 持续监控 |\r\n| **适用场景** | 日常简单任务、跨平台协作 | 复杂多步骤项目、长期维护 |\r\n\r\n---\r\n\r\n## 数据目录\r\n\r\n`TRIPHASIC_HOME` 默认指向 `skills/.standardization/triphasic-execution/`。\r\n\r\n| 路径 | 说明 | 规范分类 |\r\n|------|------|---------|\r\n| `TRIPHASIC_HOME/config.json` | 用户配置 | 根目录 |\r\n| `TRIPHASIC_HOME/default_config.json` | 默认配置模板 | 根目录 |\r\n| `TRIPHASIC_HOME/data/active/` | 活跃进度文件 | data/ |\r\n| `TRIPHASIC_HOME/data/completed/` | 已完成归档 | data/ |\r\n| `TRIPHASIC_HOME/output/PROBLEMS.md` | 问题清单 | output/ |\r\n| `TRIPHASIC_HOME/output/RISKS.md` | 风险手册 | output/ |\r\n| `TRIPHASIC_HOME/output/LESSONS_REGISTER.md` | 经验教训登记册 | output/ |\r\n| `TRIPHASIC_HOME/logs/problems.jsonl` | 问题日志 | logs/ |\r\n| `TRIPHASIC_HOME/logs/risks.jsonl` | 风险日志 | logs/ |\r\n| `TRIPHASIC_HOME/temp/` | 临时文件 | temp/ |\r\n| `TRIPHASIC_HOME/backup/` | 操作备份 | backup/ |\r\n| `TRIPHASIC_HOME/cache/` | 缓存 | cache/ |\r\n| `TRIPHASIC_HOME/state/` | 状态文件 | state/ |\r\n| `TRIPHASIC_HOME/.exec_output_pipe.txt` | exec 输出管道 | 根目录（运行期标志） |\r\n\r\n---\r\n\r\n## 安装\r\n\r\n```bash\r\npython install.py # 基础安装\r\npython install.py --mode global # 全局自动模式\r\npython install.py --target ~/.workbuddy/skills/ # 指定安装路径\r\npython install.py --home ~/.myagent/triphasic/ # 指定数据目录\r\npython install.py --uninstall # 卸载\r\n```\r\n\r\n---\r\n\r\n## 脚本清单\r\n\r\n| 脚本 | 功能 |\r\n|------|------|\r\n| `install.py` | 安装/卸载 |\r\n| `settings.py` | HTML 配置界面 |\r\n| `problem_logger.py` | 问题/风险 CRUD + 合并登记册 |\r\n| `exec_wrapper.py` | 命令执行拦截器 |\r\n| `problem_daemon.py` | 后台监控守护进程（仅全局模式） |\r\n| `lessons_register.py` | 登记册管理 |\r\n| `cron_helper.py` | 定时任务钩子 |\r\n| `task_progress.py` | 临时进度文件管理（init/update/resume/complete/abort/clean） |\r\n\r\n所有脚本零外部依赖，仅使用 Python 标准库。跨平台支持 Windows/Linux/macOS。\r\n\r\n---\r\n\r\n## 权限权重说明（R-16）\r\n\r\n本技能各操作的权限权重评估如下（由 `skill-standardization/scripts/permission_checker.py` 计算）：\r\n\r\n| 脚本 | 操作类型 | 权限权重 | 风险等级 | 说明 |\r\n|------|---------|---------|---------|------|\r\n| `task_progress.py` | 读写 `.active_tasks/*.json` | 中低 | 🟡 | 仅读写本地进度文件，无外部命令调用 |\r\n| `problem_logger.py` | 读写 `.problem_logs/*.jsonl`、合并登记册 | 中 | 🟡 | 本地日志文件写入，无网络/外部命令 |\r\n| `settings.py` | 读/写 `config.json`，启动 HTTP 服务 | 中 | 🟡 | 本地配置读写，HTTP 仅本地 `localhost` |\r\n| `install.py` | 创建目录、写配置文件、注册守护进程 | 中高 | 🟠 | 涉及目录创建和配置写入，无系统级操作 |\r\n| `problem_daemon.py` | 后台守护进程，监控任务执行 | 中 | 🟡 | 仅本地监控，无外部访问 |\r\n| `exec_wrapper.py` | 拦截命令执行，记录问题 | 中高 | 🟠 | 涉及命令执行拦截，但仅记录不更新 |\r\n| `lessons_register.py` | 读写 `LESSONS_REGISTER.md` | 低 | 🟢 | 仅本地文件读写 |\r\n| `cron_helper.py` | 定时任务钩子 | 中低 | 🟡 | 仅本地定时任务管理 |\r\n\r\n**合计权限权重**：中（所有脚本均无高风险操作）\r\n**敏感信息访问**：无（仅本地文件读写）\r\n**关键位置写入**：否（仅写入技能自身 `data/` 和 `.active_tasks/` 目录）\r\n**高权限操作**：无（无需授权）\r\n\r\n> 本技能整体风险等级：**低至中等**。所有写入操作仅限于本地用户目录，不涉及系统目录、敏感位置或网络传输。命令行拦截器（`exec_wrapper.py`）仅做记录和监控，不更新原始命令。\n\nFile v5.19.1:skill-card.md\n\n## Description:\n\nTriphasic Execution guides agents through an Execute, Review, Advance loop with semantic task parsing, planning, progress tracking, retry limits, idle cutoff rules, and issue/risk/lesson logging.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[ldxs001](https://clawhub.ai/user/ldxs001)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agent operators use this skill to impose a structured execution discipline on complex, multi-step tasks. It is intended to reduce skipped review, repeated failed attempts, and lost task state by requiring semantic parsing, planning, progress updates, and completion records.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Persistent workflow control can broadly steer agent behavior across tasks.\n\nMitigation: Use on-demand mode unless global automatic behavior is explicitly required, and review configuration before enabling daemon or wrapper features.\n\nRisk: Shell-command interception and plaintext local command-output logs can expose sensitive command context.\n\nMitigation: Avoid exec wrapper registration unless this logging is acceptable, and keep the data directory away from sensitive projects.\n\nRisk: Progress verification and cleanup behavior can read, hash, or delete local workspace artifacts.\n\nMitigation: Run the settings UI only when needed, close it afterward, and review cleanup or uninstall targets before invoking them.\n\n## Reference(s):\n\n- [Skill overview and quick start](SKILL.md)\n- [Mandatory execution rules](references/mandatory.md)\n- [Command reference, data layout, and installation](references/reference.md)\n- [FAQ](references/faq.md)\n- [Antipatterns](references/antipatterns.md)\n- [Examples](references/examples.md)\n- [Permission summary](references/permissions.md)\n- [Machine-readable permission report](references/permission_report.json)\n- [Changelog](references/changelog.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with inline shell commands and JSON configuration examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May create or update local progress, issue, risk, lesson, log, state, and configuration files when its helper scripts are used.]\n\n## Skill Version(s):\n\n5.19.1 (source: frontmatter, _meta.json, release evidence, changelog released 2026-06-09)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v5.17.3: 18 files, 58081 bytes\n\nFiles: _meta.json (139b), references/antipatterns.md (4120b), references/changelog.md (5798b), references/examples.md (5862b), references/faq.md (5594b), references/mandatory.md (18649b), references/permission_report.json (11592b), references/permissions.md (2305b), references/reference.md (7745b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (21178b), scripts/task_progress.py (33988b), skill-card.md (2757b), SKILL.md (11019b)\n\nFile v5.17.3:SKILL.md\n\n---\r\nname: triphasic-execution\r\nversion: 5.17.3\r\nauthor: wUwproject\r\nlicense: MIT\r\ndescription: Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。\r\ntags: ['framework', 'execution', 'debugging', 'problem-tracking', 'risk-tracking', 'lessons-learned', 'cross-platform', 'configuration', 'config-ui']\r\ncategory: workflow\r\ntrigger: 当用户要求执行三步循环框架/规划步骤/执行任务时；当用户需要任务进度管理/问题追踪时\r\ntrigger_negative: true\r\nsensitive_access: false\r\ncritical_write: false\r\npermission_weight: LOW\r\ndata_dir: ../.standardization/triphasic-execution/\r\nexternal_data_dir: true\r\n---\r\n# Triphasic Execution Framework\r\n执行 → 审查 → 推进。每次交互只做一件事，三者缺一不可。\r\n\r\n> → 详见 `references/antipatterns.md`\r\n> → 详见 `references/faq.md`\r\n\r\n---\r\n\r\n## 触发条件\r\n\r\n**正向触发（满足以下任意一条）：**\r\n\r\n- 说出\"三步执行\"、\"执行审查推进\"、\"triphasic\"\r\n- 说出\"问题记录\"、\"经验教训\"、\"problem logger\"\r\n- 说出\"打开 triphasic 配置\"、\"triphasic config\"\r\n- 需要结构化执行框架防止死循环或跳步\r\n- 复杂多步骤任务，需要强制进度追踪和中断恢复\r\n\r\n**否定条件（满足以下任意一条，不触发）：**\r\n\r\n- 简单问答、闲聊、问候（不需要结构化执行）\r\n- 单步任务（如\"查看文件\"、\"运行命令\"等一步完成的操作）\r\n- 用户明确说\"不要使用 triphasic\"或\"关闭 triphasic\"\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n\r\n---\r\n\r\n## 核心能力\r\n\r\n> 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。\r\n\r\n| # | 能力 | 说明 |\r\n|---|------|------|\r\n| 1 | **语义理解增强（F-01+）** | 参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力；详见 `references/mandatory.md` Phase 0 |\r\n| 2 | **步骤规划增强（F-02+）** | 参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）；详见 `references/mandatory.md` Phase 1 |\r\n| 3 | **三步循环执行** | Execute→Review→Advance，每步必须完整，不可跳过 |\r\n| 4 | **进度文件持久化（F-03/F-07/F-09）** | init→update→complete，中断后可 resume 恢复；**complete 强制校验（v5.12）** |\r\n| 5 | **问题/风险/经验记录** | 任务完成后强制记录（复杂任务 Python 侧校验），积累 PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md |\r\n| 6 | **最多 3 次重试（F-08）** | 同一步骤失败 3 次必须换方案，禁止第 4 次重试 |\r\n| 7 | **最多 3 次空转（F-11）** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，禁止第 4 次空转 |\r\n| 8 | **双模式支持** | 按需调用模式（默认）/ 全局自动模式 |\r\n| 9 | **HTML 配置界面** | `settings.py` 可视化配置技能参数 |\r\n\r\n---\r\n\r\n## 空转/重试/换思路/求助 流转规则\r\n\r\n> 详细规则见 `references/mandatory.md` Phase 2~4。\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n```bash\r\n# 按需调用（默认）— 任务开头说出关键词即可\r\n\"使用 triphasic-execution 执行以下任务：...\"\r\n\r\n# 全局自动模式 — 所有任务自动套用框架\r\n编辑 data/default_config.json → \"mode\": \"auto\"\r\n\r\n# 可视化配置\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## ⚡ [LOADING PROTOCOL]\r\n\r\nskill 加载后，AI 输出以下状态标识：\r\n\r\n```\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n```\r\n\r\n| 观察结果 | 结论 |\r\n|---------|------|\r\n| 状态输出在任务相关内容之前出现 | ✅ 执行顺序正确 |\r\n| 状态输出在任务执行后才出现 | ❌ 执行顺序错误 |\r\n| 无状态输出 | ❌ skill 未加载 |\r\n\r\n---\r\n\r\n## 🚨 [MANDATORY] 强制约束总表\r\n\r\n> **本节是整个技能的执行宪法。违反任意一条 = 违规，必须立即停止并补救。**\r\n\r\n| 序号 | 约束内容 | 触发时机 | Python 强制 |\r\n|------|---------|---------|------------|\r\n| **F-01** | 收到任务后首先执行语义拆分，禁止直接进入规划 | 收到任务第一个响应 | ❌ AI 自觉 |\r\n| **F-02** | 语义拆分完成后必须输出【任务规划】，禁止直接执行 | 语义拆分输出后 | ❌ AI 自觉（需用户确认规划）|\r\n| **F-03** | 任务规划输出后立即调用 `task_progress.py init` | 规划确认后 | ✅ 文件不存在则后续 update/complete 报错 |\r\n| **F-04** | 每步 EXECUTE 开始前重述本步骤任务目的 | 每步执行前 | ❌ AI 自觉 |\r\n| **F-05** | 每步执行后必须紧跟 REVIEW，禁止连续执行两步 | 每步执行后 | ❌ AI 自觉 |\r\n| **F-06** | 每步 REVIEW 后必须紧跟 ADVANCE | 每步 REVIEW 后 | ❌ AI 自觉 |\r\n| **F-07** | 每步 ADVANCE 后调用 `task_progress.py update` | 每步 ADVANCE 后 | ✅ update 校验 init 存在性 |\r\n| **F-08** | 同一步骤失败 3 次后必须换方案，禁止第 4 次重试 | 重试计数达到 3 | ⚠️ 部分（update 记录重试次数）|\r\n| **F-09** | 任务完成后调用 `task_progress.py complete` | 任务完成时 | ✅ **v5.12 强制**：校验步骤完成率、记录文件、summary.json |\r\n| **F-10** | 任务完成后必须输出【任务完成】总结 | 任务结束时 | ⚠️ 部分（summary.json 自动生成）|\r\n| **F-11** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入 | 空转计数达到 3 | ❌ AI 自觉（截断后等待用户输入触发词重新激发）|\r\n| **F-12** | 换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环 | 换思路请求产生时 | ❌ AI 自觉（换思路也走完整三步）|\r\n| **F-13** | 推进阶段成功后，坚决不倒回已画√的步骤 | 推进决策时 | ❌ AI 自觉 |\r\n\r\n### 自检指令\r\n\r\n```\r\n[自检] 当前阶段：[阶段名称]\r\n- F-01 语义拆分：[已完成/待执行]\r\n- F-02 任务规划：[已完成/待执行]\r\n- F-03 进度文件创建：[已完成/待执行]\r\n- 当前步骤 N：[待执行/执行中/已完成]\r\n- 重试计数：[0/1/2/3/超次]\r\n- 空转计数：[0/1/2/3/超次]\r\n违规项：[无/F-XX 描述]\r\n```\r\n\r\n---\r\n\r\n## 工作流程\r\n\r\n```\r\n用户任务\r\n ↓ [F-01 MANDATORY]\r\n语义拆分 → 输出块分析（主语/目的/诉求/动机）[增强：5W2H + 约束标注]\r\n ↓ [F-02 MANDATORY]\r\n任务规划 → 明确目的/要求/工具/结果/风险 → 确认执行 [增强：参考 skill-sub 规划逻辑]\r\n ↓ [F-03 MANDATORY]\r\ntask_progress.py init → 创建进度文件\r\n ↓\r\n执行循环（每步骤）：\r\n 🔧 EXECUTE（重述目的 → 执行）[空转计数]\r\n ↓ [F-05]\r\n 🔍 REVIEW（✅/❌/⚠️ + 证据）[重试计数/空转计数]\r\n ↓ [F-06]\r\n 📍 ADVANCE（继续/换方案/求助/完成）[截断/触发词重启]\r\n ↓ [F-07]\r\n task_progress.py update\r\n ↓\r\n任务完成\r\n ↓ [F-09] task_progress.py complete\r\n ↓ [F-10] 输出【任务完成】总结\r\n ↓ [MANDATORY] 问题/风险/经验记录\r\n```\r\n\r\n### 🔴 任务完成后的强制输出协议（AI 必读）\r\n\r\n> **每完成一个任务后，AI 必须执行以下 3 步，不可跳过。**\r\n> 不管任务成败，只要有实际工作产出，就必须记录。\r\n\r\n| 步骤 | 命令 | 说明 |\r\n|------|------|------|\r\n| 1 | `task_progress.py complete --task \"名称\"` | 完成任务，强制校验记录文件 |\r\n| 2 | `problem_logger.py add --scene \"场景\" --symptom \"现象\" --cause \"原因\" --solution \"方案\" --task \"任务\"` | 每遇到一个非 trivial 问题都记录 |\r\n| 3 | `problem_logger.py merge-to-lessons` | 任务完全完成后，合并所有待合并条目到 LESSONS_REGISTER.md |\r\n\r\n→ 完整用法见下方「快速命令」章节\r\n→ 数据目录：`~/.workbuddy/.standardization/triphasic-execution/`（符合 R-11/R-12 规范）\r\n\r\n→ 详细规则、模板、禁止行为清单见 `references/mandatory.md`\r\n→ 完整示例见 `references/examples.md`\r\n→ CLI 命令、进度文件、数据目录、安装见 `references/reference.md`\r\n\r\n---\r\n\r\n## 循环规则（摘要）\r\n\r\n1. **语义拆分先行** — 收到任务的第一个动作（增强：5W2H + 约束强度标注）\r\n2. **规划先行** — 所有任务必须先输出任务规划（增强：参考 skill-sub 规划逻辑）\r\n3. **临时文件持久化** — init → update（每步）→ complete\r\n4. **最小单元** — 单次工具调用，每步立即审查+推进\r\n5. **最多 3 次重试** — 3 次失败后必须换方案\r\n6. **最多 3 次空转** — 3 次空转后必须截断并请求触发词输入\r\n7. **大任务才拆分** — 3步以上输出步骤列表\r\n8. **中断可恢复** — 进度文件保留，重启后 resume\r\n9. **换思路走完整三步** — 禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 快速命令\r\n\r\n```bash\r\n# 进度文件\r\npython {SKILL_DIR}/scripts/task_progress.py init --task \"名称\" --purpose \"目的\" --requirements \"要求\" --risks \"风险\" --steps '[...]'\r\npython {SKILL_DIR}/scripts/task_progress.py update --task \"名称\" --step 1 --status success --review \"...\" --advance \"...\"\r\npython {SKILL_DIR}/scripts/task_progress.py complete --task \"名称\" # --force 跳过步骤检查；--no-enforce 关闭记录校验\r\npython {SKILL_DIR}/scripts/task_progress.py resume --task \"名称\"\r\n\r\n# 问题/风险/经验\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"场景\" --symptom \"症状\" --cause \"原因\" --solution \"方案\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py add-risk --description \"风险\" --impact \"影响\" --mitigation \"缓解\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r\n\r\n# 配置界面\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## 渐进式 MD 文件体系\r\n\r\n| 本文件（SKILL.md）包含 | 拆分到 references/ |\r\n|---|---|\r\n| ✅ 触发条件、核心能力、强制约束总表 | 📄 `mandatory.md` — Phase 0~4 详细规则、模板、禁止行为、空转/重试/换思路流转 |\r\n| ✅ 工作流程概述、循环规则 | 📄 `examples.md` — 完整执行示例（含空转/重试/换思路场景） |\r\n| ✅ 快速命令 | 📄 `reference.md` — 进度文件机制、问题记录、安装、数据目录 |\r\n| | 📄 `antipatterns.md` — 反模式收录（AP-01~AP-08） |\r\n| | 📄 `faq.md` — 常见问题（Q&A 1~12） |\r\n\r\n---\r\n\r\n## 版本\r\n\r\n当前版本：**5.17.1** — v5.17.1：数据目录迁移到 .standardization/triphasic-execution/；cmd_add 同步写 PROBLEMS.md；SKILL.md 新增强制输出协议；task_progress.py complete 路径修正。\n\nFile v5.17.3:_meta.json\n\n{\n \"ownerId\": \"kn75zfd51df61ajdyqtgvrs1hx84s4q6\",\n \"slug\": \"triphasic-execution\",\n \"version\": \"5.17.3\",\n \"publishedAt\": 1780170673949\n}\n\nFile v5.17.3:references/antipatterns.md\n\n# Triphasic Execution - 反模式（Antipatterns）\r\n\r\n本文档收录使用本技能时的常见错误和注意事项。\r\n\r\n---\r\n\r\n## 反模式列表\r\n\r\n### ❌ AP-01：跳过语义拆分直接规划\r\n\r\n**错误做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[直接输出任务规划]\r\n```\r\n\r\n**正确做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[首先输出语义拆分]\r\n - 主语：用户\r\n - 目的：修复 bug\r\n - 诉求：定位并修复代码错误\r\n - 动机：恢复功能正常\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-02：跳过审查直接推进\r\n\r\n**错误做法：**\r\n```\r\nEXECUTE → [无 REVIEW] → ADVANCE\r\n```\r\n\r\n**正确做法：**\r\n```\r\nEXECUTE → REVIEW（✅/❌/⚠️ + 证据）→ ADVANCE\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-03：同一步骤无限重试\r\n\r\n**错误做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 重试\r\n第 4 次失败 → 重试（❌ 违反 F-08）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 换方案（✅ 遵守 F-08）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-04：进度文件未创建就执行\r\n\r\n**错误做法：**\r\n```\r\n任务规划 → [无 ttask_progress.py init] → 直接执行\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务规划 → ttask_progress.py init → 执行（✅ 遵守 F-03）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-05：任务完成未调用 complete\r\n\r\n**错误做法：**\r\n```\r\n任务执行完 → [无 ttask_progress.py complete] → 结束\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务执行完 → ttask_progress.py complete → 输出总结（✅ 遵守 F-09）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-06：中英文混排缺少空格\r\n\r\n**错误做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n**正确做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-07：空转超过 3 次未截断（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n第 1 次空转 → 继续\r\n第 2 次空转 → 继续\r\n第 3 次空转 → 继续\r\n第 4 次空转 → 继续（❌ 违反 F-11）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次空转 → 重述规划，明确要求必须执行\r\n第 2 次空转 → 重述规划，明确要求必须执行\r\n第 3 次空转 → 主动截断，请求用户输入触发词（✅ 遵守 F-11）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-08：换思路时三步骤内部直接循环（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n换思路 → 直接执行新方案（❌ 跳过 REVIEW→ADVANCE）\r\n换思路 → 直接推进（❌ 跳过 EXECUTE→REVIEW）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n换思路 → 原封不动推送到 REVIEW\r\n ↓\r\n REVIEW（记录换思路，不确认执行）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步循环）（✅ 遵守 F-12）\r\n```\r\n\r\n---\r\n\r\n## 注意事项\r\n\r\n1. **语义拆分是强制的** — 收到任务第一个动作必须是语义拆分，不能跳过\r\n2. **规划必须用户确认** — F-02 要求规划输出后需用户确认才能执行\r\n3. **三步循环不可跳过** — Execute→Review→Advance 缺一不可\r\n4. **进度文件必须创建** — F-03 强制要求 init，否则后续 update/complete 会报错\r\n5. **最多 3 次重试** — F-08 强制要求，第 4 次必须换方案\r\n6. **最多 3 次空转** — F-11 强制要求，第 4 次必须截断并请求触发词输入\r\n7. **换思路必须走完整三步** — F-12 强制要求，禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 常见问题排查\r\n\r\n| 问题 | 原因 | 解决方案 |\r\n|------|------|----------|\r\n| `ttask_progress.py update` 报错 | 未执行 `init` | 先执行 `ttask_progress.py init` |\r\n| `complete` 校验失败 | 步骤完成率不足 | 检查哪些步骤未标记为 success |\r\n| 重试次数超限 | 同一方案失败 3 次 | 换方案，禁止第 4 次重试 |\r\n| 进度文件丢失 | 误删除或路径错误 | 重新执行 `init`，或手动创建进度文件 |\n\nFile v5.17.3:references/changelog.md\n\n## 5.17.3 (2026-05-31)\r\n\r\n### 修复\r\n- **R-04**: description 移除版本号\r\n- **R-06**: H1 移除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n## 5.17.2 (2026-05-30)\r\n\r\n### 修复\r\n- **R-04**: description 移除版本号\r\n- **R-06**: H1 移除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n# triphasic-execution 版本更新日志\r\n## v5.17.0（2026-05-28）\r\n\r\n**改写类型：标准化改造 — 修复 R-11/R-20/R-23 违规**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-11 产出物路径违规：`assets/` 和 `temp_progress/` 迁至 `skills/.standardization/triphasic-execution/data/`\r\n- ✅ 修复 R-20 写作规范：`ttask_progress.py`（双t typo）→ `task_progress.py`；中英文混排补空格\r\n- ✅ 修复 R-22/R-23 文档-代码一致性：`SKILL.md`/`faq.md`/`examples.md`/`reference.md` 路径引用全部修正\r\n- ✅ 新增 frontmatter 字段：`data_dir: ../.standardization/triphasic-execution/`、`external_data_dir: true`\r\n- ✅ `assets/default_config.json` → `data/default_config.json`；`assets/settings.html` → `data/settings.html`\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 0 ERROR 0 WARN（剩余 2 WARN 为审计工具误报，非真实违规）\r\n- 数据目录合规，符合 R-11/R-12/R-22 规范\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## v5.16.0（2026-05-28）\r\n\r\n**改写类型：功能增强 — 规划能力增强 + 执行验证机制 + 强制约束落脚本**\r\n\r\n### 更新内容\r\n\r\n- ✅ 增强语义理解（F-01+）：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），Phase 0 新增注意力锚定、自我反查\r\n- ✅ 增强步骤规划（F-02+）：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），Phase 1 新增规划逻辑说明（非调用链，仅参考逻辑）\r\n- ✅ 新增 F-11：同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，由 `ttask_progress.py --idle` 脚本级强制\r\n- ✅ 新增 F-12：换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环\r\n- ✅ 新增 F-13：推进阶段成功后，坚决不倒回已画√的步骤\r\n- ✅ `ttask_progress.py` 新增字段：`idle_count`、`executed_proof`、`snapshot_before`、`snapshot_after`\r\n- ✅ `ttask_progress.py` 新增子命令：`pre_exec`（执行前文件快照）、`verify_exec`（执行后验证文件变化）\r\n- ✅ `ttask_progress.py` 新增参数：`--idle`、`--verify-execution`、`--proof`、`--clear-cache`、`--trigger-word`\r\n- ✅ `ttask_progress.py` F-08/F-11 强制约束由脚本实现（≥3次 `sys.exit(1)`），不再靠 AI 自觉\r\n- ✅ `_clear_tool_cache()` 清除 `__pycache__`/`.pyc` 等缓存，避免验证误判\r\n- ✅ `mandatory.md` Phase 2~4 新增完整空转/重试/换思路/求助流转规则\r\n- ✅ `antipatterns.md` 新增 AP-07（空转超3次未截断）、AP-08（换思路时三步骤内部直接循环）\r\n- ✅ `faq.md` 新增 Q11（什么是空转）、Q12（换思路为什么要走完整三步循环）\r\n- ✅ 修复 `_meta.json` 版本号描述拼写错误\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计预期 0 ERROR 0 WARN\r\n- 空转/重试约束从\"AI 自觉\"升级为\"脚本强制\"\r\n- 执行验证支持文件系统级证据（mtime + hash 对比）\r\n\r\n---\r\n\r\n## v5.15.0（2026-05-25）\r\n\r\n**改写类型：Bug 修复 — R-20 术语不一致 + 中英文混排 + 拼写错误**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-20 术语不一致（\"配置\" → \"配置\"、\"更新\" → \"更新\"）\r\n- ✅ 修复 R-20 中英文混排缺少空格（\"Bug\" → \"Bug \"、\"Token\" → \"Token \" 等）\r\n- ✅ 修复拼写错误（`tAsk_progress.py` → `ttask_progress.py`）\r\n- ✅ 修复 `## 核心能力` 章节渐进式加载说明（通过 R-21 检查）\r\n- ✅ 修复触发条件否定条件（添加单步任务不触发的说明）\r\n- 📦 更新 `_meta.json` 和 `SKILL.md` 版本号至 v5.15.0\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 21/21 PASS（0 ERROR）\r\n- R-20 写作规范全面符合\r\n- 渐进式加载说明显式化\r\n\r\n---\r\n\r\n## v5.14.0（2026-05-24）\r\n\r\n**改写类型：skill-standardization refactor 正确改造**\r\n\r\n### 更新内容\r\n- ✅ 使用 `refactor` 模式正确改造（先 `--dry-run` 再实际执行）\r\n- ✅ 自动备份：`triphasic-execution_bak_refactor_20260524_230726`\r\n- ✅ 调用 `permission_checker.py` 扫描脚本权限（8 文件 / 3219 行）\r\n- ✅ 权限扫描结果：风险等级 MEDIUM，权重 50%，28 个问题（27 HIGH + 1 MEDIUM）\r\n- ✅ 生成 `references/permission.md`（基于扫描报告，非手写）\r\n- ✅ 生成 `references/permission_report.json`（机器可读）\r\n\r\n### 权限扫描摘要\r\n| 权限类型 | 次数 |\r\n|---------|------|\r\n| `subprocess_call` | 21 |\r\n| `file_delete` | 6 |\r\n| `network_access` | 1 |\r\n| `sensitive_access` | 0 |\r\n| `critical_write` | 0 |\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=16（全规则通过）\r\n\r\n---\r\n\r\n## v5.10.1（2026-05-23）\r\n\r\n**改写类型：skill-standardization 标准化审查**\r\n\r\n### 更新内容\r\n- 标准化审查通过，无需更新（R-01~R-11 全部合规）\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=5\r\n\r\n---\r\n\r\n## 版本历史\r\n\r\n> 详细版本历史参见 git 提交记录。\r\n> 标准化审查前的版本信息由 SKILL.md frontmatter `version` 和 git tag 追溯。\n\nFile v5.17.3:references/examples.md\n\n# examples.md — 完整执行流程示例\r\n\r\n> 本文件包含 triphasic-execution 的完整示例，供参考学习时加载。\r\n\r\n---\r\n\r\n## 示例：多步任务（标准完整流程）\r\n\r\n```\r\n用户：请帮我修复登录接口 Bug\r\n\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n\r\n[自检] 当前阶段：收到任务\r\n- F-01 语义拆分：待执行\r\n- F-02 任务规划：待执行\r\n违规项：无，执行语义拆分\r\n\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n请帮我修复登录接口 Bug\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：用户\r\n 角色：requester\r\n 目的：登录接口恢复正常\r\n 诉求：\r\n 1. 修复登录接口中的 Bug\r\n 动机：当前登录功能存在问题\r\n\r\n## 块 2：执行者\r\n 角色：executor\r\n 目的：定位并修复登录接口 Bug\r\n 诉求：\r\n 1. 读取代码定位问题\r\n 2. 修复代码\r\n 3. 验证修复有效\r\n 动机：块1的所有要求\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n\r\n【任务规划】修复登录接口 Bug\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞\r\n📋 具体要求：添加 Token 验证逻辑，确保未携带有效 Token 的请求被拒绝\r\n⚠️ 潜在风险：更新可能影响正常登录流程\r\n\r\n**执行步骤**：\r\n 步骤 1: 读取登录接口代码\r\n - 任务目的：获取当前代码，理解认证逻辑现状\r\n - 工具/命令：`Read`\r\n - 操作说明：读取 login.py 文件\r\n - 预期结果：获取完整代码内容\r\n - 潜在风险：文件不存在\r\n\r\n 步骤 2: 修复代码\r\n - 任务目的：添加缺失的 Token 验证逻辑\r\n - 工具/命令：`Edit`\r\n - 操作说明：在指定位置添加验证逻辑\r\n - 预期结果：代码更新成功，无语法错误\r\n - 潜在风险：语法错误、引入新 bug\r\n\r\n 步骤 3: 测试验证\r\n - 任务目的：验证修复有效且未影响正常功能\r\n - 工具/命令：`Bash`（pytest）\r\n - 操作说明：运行测试用例\r\n - 预期结果：测试通过\r\n - 潜在风险：测试环境问题\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]：\r\n → 问题记录 → 风险记录 → 经验积累\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r\n\r\n→ [MANDATORY-F-03] 创建进度文件：\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"修复登录 Bug\" \\\r\n --purpose \"修复 Token 验证缺失导致的认证绕过漏洞\" \\\r\n --requirements \"添加 Token 验证逻辑\" \\\r\n --risks \"可能影响正常登录\" \\\r\n --steps '[{\"description\":\"读取代码\",\"purpose\":\"理解认证逻辑\",\"tool\":\"Read\"},{\"description\":\"修复代码\",\"purpose\":\"添加验证\",\"tool\":\"Edit\"},{\"description\":\"测试验证\",\"purpose\":\"确认修复有效\",\"tool\":\"Bash\"}]'\r\n\r\n### 🔧 [EXECUTE] - 步骤 1\r\n🔧 执行前重述目的：获取当前代码，理解认证逻辑现状\r\n（读取 login.py...）\r\n\r\n### 🔍 [REVIEW] - 步骤 1\r\n✅成功 -- 发现 Token 验证逻辑缺失\r\n\r\n### 📍 [ADVANCE] - 步骤 1\r\n推进：继续步骤 2\r\n→ 更新进度文件：python {SKILL_DIR}/scripts/task_progress.py update --task \"修复登录 Bug\" --step 1 --status success --review \"发现 Token 验证缺失\" --advance \"继续步骤2\"\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：1/3（33%）▸ 下一：步骤2\r\n\r\n...（继续步骤 2-3）\r\n\r\n【任务完成】\r\n- 目标：修复登录接口 Bug\r\n- 结果：✅成功 -- Token 验证已添加\r\n- 进度：3/3（100%）\r\n→ [MANDATORY-F-09] python {SKILL_DIR}/scripts/task_progress.py complete --task \"修复登录 Bug\"\r\n```\n\nFile v5.17.3:references/faq.md\n\n# Triphasic Execution - 常见问题（FAQ）\r\n\r\n本文档收录使用本技能时的常见问题和解答。\r\n\r\n---\r\n\r\n## Q&A 列表\r\n\r\n### Q1：什么时候应该使用 triphasic-execution？\r\n\r\n**A：** 当任务满足以下任一条件时：\r\n- 多步骤任务（≥3 步）\r\n- 容易出现死循环或无限重试\r\n- 需要中断恢复能力\r\n- 需要结构化的问题/风险/经验记录\r\n\r\n**不适合的场景：**\r\n- 简单问答（单步即可完成）\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n- 用户明确要求不使用本技能\r\n\r\n---\r\n\r\n### Q2：语义拆分是什么？为什么要强制？\r\n\r\n**A：** 语义拆分是将用户任务拆解为结构化字段：\r\n- **主语**：谁发起的任务\r\n- **目的**：为什么要做这个任务\r\n- **诉求**：具体要做什么\r\n- **动机**：深层需求是什么\r\n\r\n**强制原因：** 防止 AI 误解任务意图，导致执行方向错误。\r\n\r\n---\r\n\r\n### Q3：F-02 要求规划必须用户确认，能不能跳过？\r\n\r\n**A：** 不能。F-02 是强制约束（用 ❌ AI 自觉 标记），必须输出规划并等待用户确认后才能执行。\r\n\r\n**例外：** 如果用户明确说\"直接执行\"、\"不需要确认\"，可以跳过，但需要在规划中说明。\r\n\r\n---\r\n\r\n### Q4：task_progress.py 有什么用？不用行不行？\r\n\r\n**A：** `task_progress.py` 用于持久化进度，支持中断恢复。F-03 强制要求调用 `init`，F-07 强制要求每步调用 `update`，F-09 强制要求任务完成时调用 `complete`。\r\n\r\n**不用的后果：**\r\n- 任务中断后无法恢复\r\n- 无法追踪步骤完成率\r\n- `complete` 校验会失败（v5.12+）\r\n\r\n---\r\n\r\n### Q5：同一步骤失败 3 次后必须换方案，能不能第 4 次重试？\r\n\r\n**A：** 不能。F-08 是强制约束，第 4 次重试违反规范。\r\n\r\n**正确做法：**\r\n- 第 1~3 次：尝试同一方案\r\n- 第 3 次失败后：换方案（完全不同思路）\r\n- 新方案再失败：继续换，直到任务完成或所有方案耗尽\r\n\r\n---\r\n\r\n### Q6：`complete` 校验失败怎么办？\r\n\r\n**A：** `complete` 校验检查以下内容：\r\n1. 步骤完成率（所有步骤必须标记为 success）\r\n2. 记录文件（PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md）\r\n3. summary.json（任务总结）\r\n\r\n**修复方法：**\r\n- 完成所有未完成的步骤\r\n- 运行 `problem_logger.py add` 记录问题/风险\r\n- 运行 `task_progress.py complete --force` 跳过步骤检查（不推荐）\r\n- 运行 `task_progress.py complete --no-enforce` 关闭记录校验（不推荐）\r\n\r\n---\r\n\r\n### Q7：按需调用模式和全局自动模式有什么区别？\r\n\r\n**A：**\r\n- **按需调用（默认）**：用户说出关键词（\"三步执行\"、\"triphasic\"等）才触发\r\n- **全局自动模式**：所有任务自动套用框架，无需关键词\r\n\r\n**切换方法：**\r\n编辑 `data/default_config.json` → `\"mode\": \"auto\"`\r\n\r\n---\r\n\r\n### Q8：settings.py 是干什么的？\r\n\r\n**A：** `settings.py` 是一个 HTML 可视化配置界面，用于配置技能参数（如模式、重试次数、记录文件路径等）。\r\n\r\n**运行方法：**\r\n```bash\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n### Q9：SKILL_DIR 是什么？为什么代码块里用这个变量？\r\n\r\n**A：** `SKILL_DIR` 是一个变量，表示技能安装目录（如 `~/.workbuddy/skills/triphasic-execution`）。\r\n\r\n**为什么用变量：** SKILL.md 是模板文件，实际路径由 AI 根据环境替换。\r\n\r\n**人工阅读时：** 看到 `{SKILL_DIR}` 请自动替换为实际路径。\r\n\r\n---\r\n\r\n### Q10：为什么我的任务被阻断了？\r\n\r\n**A：** 可能被以下约束阻断：\r\n- **F-01**：未输出语义拆分\r\n- **F-02**：未输出任务规划\r\n- **F-03**：未调用 `task_progress.py init`\r\n- **F-07**：未调用 `task_progress.py update`\r\n- **F-08**：同一步骤失败 3 次未换方案\r\n- **F-09**：未调用 `task_progress.py complete`\r\n\r\n**解决方法：** 检查 [自检指令] 输出，看哪个 F-XX 未通过。\r\n\r\n---\r\n\r\n### Q11：什么是\"空转\"？空转 3 次截断是什么意思？（v5.16.0 新增）\r\n\r\n**A：** 空转指 EXECUTE 阶段没有实际执行任何操作（仅输出描述、未调用工具），却进入了 REVIEW 阶段。\r\n\r\n**空转计数规则：**\r\n- 每次 EXECUTE 阶段未实际执行 → 空转计数 +1\r\n- 空转计数 ≤3 次 → 重述规划，明确要求必须执行\r\n- 空转计数 >3 次 → 主动截断，请求用户输入固定触发词打破空转\r\n\r\n**触发词：** `继续执行`（用户可自定义，见配置）\r\n\r\n---\r\n\r\n### Q12：换思路时为什么要走完整三步循环？（v5.16.0 新增）\r\n\r\n**A：** 换思路时如果直接执行或直接推进，会跳过 REVIEW 或 EXECUTE，导致三步循环断裂，属于违反 F-12。\r\n\r\n**正确流转：**\r\n```\r\n换思路产生 → 原封不动推送到 REVIEW（不确认执行）\r\n ↓\r\n REVIEW（记录换思路）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步）\r\n```\r\n\r\n**核心原则：** 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考。没有任何三步骤内部直接循环的情况。\r\n\r\n---\r\n\r\n## 其他问题\r\n\r\n如果这里没有你的问题，请运行：\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"文档\" --symptom \"FAQ 缺少问题 XXX\" --cause \"未收录\" --solution \"补充到 faq.md\"\r\n```\n\nFile v5.17.3:references/mandatory.md\n\n# mandatory.md — 强制约束详细规则\r\n\r\n> 本文件包含 triphasic-execution 的完整强制约束内容，供需要深入了解规则细节时加载。\r\n\r\n---\r\n\r\n## Phase 0 —— 语义拆分完整规则（增强版 v5.16.0）\r\n\r\n> **违反 F-01：如果 AI 没有输出语义拆分就开始规划或执行，属于严重违规。必须回滚并先输出拆分结果。**\r\n> **v5.16.0 增强**：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力。\r\n\r\n### 拆分规则（增强版）\r\n\r\n**块（Block）识别**：按主语划分，每个主语构成一个块。\r\n\r\n| 主语类型 | 识别方式 |\r\n|---------|---------|\r\n| 用户（\"我\"） | 说话者本人 |\r\n| AI 助手（\"你\"） | 执行者、帮助者 |\r\n| 第三方（\"他/她/它\"） | 提及的其他角色 |\r\n\r\n**每个块提取三类信息：**\r\n\r\n| 元素 | 定义 | 增强标注 |\r\n|-----|------|---------|\r\n| **目的** | 最终要达成的目标 | 标注🔴🟡⚪约束强度 |\r\n| **诉求** | 需要执行的具体操作或交付物 | 硬约束🔴/软约束🟡/无约束⚪ |\r\n| **动机** | 为什么会产生这个需求 | 背景/原因/情绪 |\r\n\r\n### v5.16.0 新增：5W2H 维度提取（参考 semantic-split）\r\n\r\n**步骤 0.5**：任务类型识别与 5W2H 初始化（内部执行，不输出）\r\n\r\n1. **任务类型识别**：制作PPT / 填写周报 / 安排行程 / 写邮件 / 策划活动 / 其他\r\n2. **5W2H 维度初始化**：按任务类型从默认映射表填入默认值\r\n3. **约束强度预标注**：🔴硬约束 / 🟡软约束 / ⚪无约束\r\n\r\n**步骤 0.7**：注意力锚定（内部执行，不输出）\r\n\r\n1. `[CRITICAL]` — 硬约束，后续不可违反\r\n2. `[CORE]` — 核心目标（动词+宾语）\r\n3. `[ENTITY]` — 数字、时间、人名\r\n4. `[EXAMPLE]` — 举例内容，降权不作为约束\r\n5. `[RESISTANCE]` — 「但是/担心/难」后内容\r\n6. 核心句重构：「[主语] 要 [CORE] 于 [时间/场景]」（≤20字）\r\n\r\n### v5.16.0 新增：自我反查（内部执行，不输出）\r\n\r\n| 反查 | 检查内容 | 修正 |\r\n|------|---------|------|\r\n| 1 | 硬约束遗漏：`[CRITICAL]` 是否全在结果中？ | 补充 |\r\n| 2 | 约束误判：🟡 词被标为 🔴？ | 修正 |\r\n| 2b | 隐式升级：🟡 约束属组织规范/法律/安全？→ 🟡🔴 或 🔴 | 升级 |\r\n| 3 | 举例干扰：`[EXAMPLE]` 被当核心诉求？ | 降级 |\r\n| 4 | 5W2H 缺失：有明显可推断维度？ | 补充 `[推断]` |\r\n\r\n### 输出格式（[MANDATORY] 必须按此格式输出）\r\n\r\n```\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n[用户原话完整引用]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：[主语名称]\r\n 角色：[用户/执行者/第三方]\r\n 目的：[该主语要达成的核心目标] 🔴/🟡/⚪\r\n 诉求：\r\n 1. [诉求点1] 🔴/🟡/⚪\r\n 2. [诉求点2] 🔴/🟡/⚪\r\n 3. [诉求点3] 🔴/🟡/⚪\r\n 动机：[产生该需求的背景/原因/情绪]\r\n\r\n## 块 2：[主语名称]\r\n 角色：[执行者]\r\n 目的：[执行者要达成的目标]\r\n 诉求：\r\n 1. [需要执行的行为1]\r\n 2. [需要执行的行为2]\r\n 动机：[块1的所有要求]\r\n\r\n**5W2H 维度**：\r\n - Why（为什么）：[值] 🔴/🟡/⚪\r\n - What（做什么）：[值] 🔴/🟡/⚪\r\n - Who（谁参与）：[值] 🔴/🟡/⚪\r\n - Where（在哪里）：[值] 🔴/🟡/⚪\r\n - When（什么时候）：[值] 🔴/🟡/⚪\r\n - How（怎么做）：[值] 🔴/🟡/⚪\r\n - How much（多少）：[值] 🔴/🟡/⚪\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n```\r\n\r\n---\r\n\r\n## Phase 1 —— 任务规划完整模板（增强版 v5.16.0）\r\n\r\n> **违反 F-02：如果 AI 在输出【语义拆分】后没有输出【任务规划】就开始执行，属于严重违规。**\r\n> **v5.16.0 增强**：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）。\r\n\r\n### 判断流程（增强版）\r\n\r\n```\r\n收到任务\r\n │\r\n ├─ [MANDATORY] 第零步：语义拆分（F-01，必做）[增强：5W2H + 约束标注]\r\n │ → 输出块分析：主语/目的/诉求/动机 + 5W2H维度 + 约束强度\r\n │\r\n ├─ [MANDATORY] 第一步：任务规划（F-02，必做，所有任务）[增强：参考skill-sub规划逻辑]\r\n │ → 明确：任务目的、具体要求、使用工具、预期结果、潜在风险\r\n │ → [增强] 步骤排序（参考skill-sub的意图理解→步骤排序逻辑）\r\n │ → [增强] 执行计划生成（参考skill-sub的执行计划生成逻辑）\r\n │\r\n ├─ 第二步：判断是否需要拆分\r\n │ ├─ 单步任务（1个操作可完成）→ 直接进入执行\r\n │ └─ 多步任务（2个以上操作）→ 任务拆分，列出子步骤\r\n │\r\n ├─ [MANDATORY] 第三步：创建进度文件（F-03，规划确认后立即执行）\r\n │ → 调用 ttask_progress.py init\r\n │\r\n └─ 第四步：进入 Execute→Review→Advance 循环\r\n```\r\n\r\n### v5.16.0 新增：参考 skill-sub 的规划逻辑（非调用链）\r\n\r\n**意图理解**（参考 skill-sub 的\"理解意图\"阶段）：\r\n- 分析用户输入，判断任务类型\r\n- 识别核心目标与约束条件\r\n- 输出：任务意图摘要\r\n\r\n**步骤排序**（参考 skill-sub 的\"规划技能顺序\"阶段）：\r\n- 推荐参与的工具/命令及其顺序\r\n- 标记步骤依赖关系\r\n- 输出：步骤顺序列表（含并行/串行标记）\r\n\r\n**执行计划生成**（参考 skill-sub 的\"生成执行计划\"阶段）：\r\n- 输出 AI 可直接执行的指令序列\r\n- 含并行/串行标记、里程碑位置\r\n- 输出：执行计划（非调用链JSON，仅为步骤描述）\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**步骤排序**（参考 skill-sub 规划逻辑）：\r\n 步骤 N: [操作描述] ── serial/parallel ── depends_on: [依赖]\r\n constraint_level: 🔴/🟡/⚪\r\n\r\n**执行计划**（参考 skill-sub 执行计划生成逻辑）：\r\n 1. [具体操作1]\r\n 2. [具体操作2]\r\n ...\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n**请确认执行（输入选项，调整请同时说明要求）**：\r\n1. 执行全部（包括问题/风险/经验记录）\r\n2. 执行但跳过问题/风险/经验记录\r\n3. 取消任务\r\n4. 调整任务\r\n\r\n请输入：\r\n```\r\n\r\n### 任务拆分模板（仅大任务，3步以上）\r\n\r\n```\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 步骤 2: [操作描述]\r\n ...\r\n\r\n**步骤排序**（参考 skill-sub）：\r\n 步骤 1 ── serial ── milestone: ✅/❌\r\n 步骤 2 🟡: [名称]（增强：来自发散方案）\r\n ⚠️ 风险：[说明]（如涉及🔴突破）\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]（必须执行，除非用户明确跳过）：\r\n → 问题记录：回顾执行过程，识别问题 → 调用 add\r\n → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r\n → 经验积累：执行完成后 → 调用 merge-to-lessons\r\n\r\n**临时进度文件**：规划确认后立即创建（F-03），每步更新（F-07），完成后删除（F-09）\r\n```\r\n\r\n---\r\n\r\n## Phase 2~4 —— 执行/审查/推进循环详细规则（增强版 v5.16.0）\r\n\r\n### [MANDATORY] EXECUTE 阶段规则\r\n\r\n> **违反 F-04：如果 AI 执行步骤前没有重述本步骤任务目的，属于违规。**\r\n> **v5.16.0 增强**：明确空转计数规则。\r\n\r\n- **[MANDATORY]** 执行前必须输出：`🔧 执行前重述目的：[本步骤目的]`\r\n- 实际运行命令、调用工具、测试代码\r\n- 只跑一个主要命令（可并行多个独立命令）\r\n- 不提前分析结果，不跳到审查阶段\r\n- **[v5.16.0 新增]** 空转判断：如果执行阶段没有实际执行任何操作（仅输出描述、未调用工具），则视为空转，空转计数+1\r\n\r\n### [MANDATORY] REVIEW 阶段规则\r\n\r\n> **违反 F-05：如果 AI 执行步骤后没有输出 REVIEW，属于违规，不得继续执行下一步。**\r\n> **v5.16.0 增强**：明确空转计数、重试计数、换思路到达的处理规则。\r\n\r\n- **[MANDATORY]** 执行后必须紧跟 REVIEW，给出明确判断：✅成功 / ❌失败 / ⚠️部分\r\n- 列出具体证据（数据、错误码、状态）\r\n- **[MANDATORY]** 对照任务目的判断是否达成\r\n- 不执行新操作\r\n- **[v5.16.0 新增]** 空转未执行 → 空转计数+1，不画√\r\n- **[v5.16.0 新增]** 重试失败 → 重试计数+1\r\n- **[v5.16.0 新增]** 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n\r\n### [MANDATORY] ADVANCE 阶段规则\r\n\r\n> **违反 F-06：如果 AI REVIEW 后没有输出 ADVANCE，属于违规，不得跳到下一步。**\r\n> **v5.16.0 增强**：明确成功/失败/空转/换思路的完整流转规则，禁止三步骤内部直接循环。\r\n\r\n- **[MANDATORY]** REVIEW 后必须紧跟 ADVANCE，明确：继续 / 换方向 / 结束 / 向上返回\r\n- **[MANDATORY]** 更新进度追踪表，标记当前步骤状态\r\n- **[MANDATORY]** 调用 `ttask_progress.py update` 持久化进度（F-07）\r\n- 不直接执行，只规划\r\n- **[v5.16.0 新增]** 成功：根据步骤确定接下来要执行什么，推进执行；**坚决不倒回已画√的步骤**\r\n- **[v5.16.0 新增]** 失败：根据重试次数明确重试 或 换思路 或 求助\r\n- **[v5.16.0 新增]** 空转：重述之前规划并告知执行必须执行 或 主动截断\r\n- **[v5.16.0 新增]** 换思路：原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n\r\n### v5.16.0 新增：空转/重试/换思路/求助 完整流转规则\r\n\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n#### 执行阶段（EXECUTE）流转规则\r\n\r\n```\r\n执行阶段（EXECUTE）\r\n ├─ 实际执行成功 → 进入 REVIEW\r\n ├─ 实际执行失败 → 重试计数+1\r\n │ ├─ 重试≤3次 → 继续重试执行\r\n │ └─ 重试>3次 → 换思路 或 求助用户\r\n ├─ 空转（未实际执行）→ 空转计数+1\r\n │ ├─ 空转≤3次 → 重述规划，明确要求必须执行\r\n │ └─ 空转>3次 → 主动截断，请求用户输入固定触发词打破空转\r\n └─ 换思路 → 原封不动推送到 REVIEW（不确认执行）\r\n```\r\n\r\n#### 审查阶段（REVIEW）流转规则\r\n\r\n```\r\n审查阶段（REVIEW）\r\n ├─ 确认上一步执行逻辑无误 → 步骤画√（✅）\r\n ├─ 空转未执行 → 空转计数+1，不画√\r\n ├─ 重试失败 → 重试计数+1\r\n ├─ 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n └─ 导入分支结果 → 记录成功或失败\r\n```\r\n\r\n#### 推进阶段（ADVANCE）流转规则\r\n\r\n```\r\n推进阶段（ADVANCE）\r\n ├─ 成功 → 根据步骤确定接下来要执行什么，推进执行；坚决不倒回已画√的步骤\r\n ├─ 失败 → 根据重试次数明确重试 或 换思路 或 求助\r\n │ ├─ 重试次数<3 → 推进重试执行\r\n │ ├─ 重试次数≥3 → 换思路 或 求助用户\r\n │ └─ 求助 → 明确发出交互请求，主动截断并等待用户输入\r\n ├─ 换思路 → 原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n │ → 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考\r\n │ → 没有任何三步骤内部直接循环的情况，每一步都是最小单元，不能自循环闭环\r\n └─ 空转 → 重述之前规划并告知执行必须执行 或 主动截断\r\n ├─ 空转次数<3 → 重述之前规划并告知执行必须执行，返回 EXECUTE\r\n └─ 空转次数≥3 → 主动截断，请求用户输入固定触发词打破空转，停止并发出交互请求\r\n```\r\n\r\n#### 固定触发词打破空转规则\r\n\r\n> **v5.16.0 新增**：当空转次数≥3次时，AI 必须主动截断当前流程，请求用户输入固定触发词来重新激发执行。\r\n\r\n**触发词**：`继续执行`（用户可自定义，见配置）\r\n\r\n**截断后行为**：\r\n1. AI 输出：`⚠️ 空转次数已达到3次，主动截断。请输入触发词\"继续执行\"以重新激发执行。`\r\n2. AI 停止当前执行循环，等待用户输入\r\n3. 用户输入触发词后，AI 重新进入 EXECUTE 阶段，重置空转计数（可选），继续执行\r\n\r\n#### 求助规则\r\n\r\n> **v5.16.0 新增**：当超出重试或空转次数时，AI 必须明确发出交互请求，主动截断并等待用户输入。\r\n\r\n**触发条件**：\r\n- 同一步骤失败，重试次数≥3次\r\n- 同一步骤空转次数≥3次\r\n- 换思路后仍无法继续执行\r\n\r\n**求助输出格式**：\r\n```\r\n⚠️ 求助请求\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n**问题描述**：[描述当前遇到的问题，为什么无法继续]\r\n\r\n**已尝试方案**：\r\n 1. [方案1]（失败原因）\r\n 2. [方案2]（失败原因）\r\n 3. [方案3]（失败原因）\r\n\r\n**需要帮助的内容**：\r\n - [具体问题1]\r\n - [具体问题2]\r\n\r\n**建议下一步**：\r\n - [建议1]\r\n - [建议2]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n请提供指导或输入触发词\"继续执行\"以继续。\r\n```\r\n\r\n### 执行输出标准格式\r\n\r\n```\r\n### 🔧 [EXECUTE] - 步骤 N\r\n🔧 执行前重述目的：[本步骤任务目的]\r\n（执行操作...）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 🔍 [REVIEW] - 步骤 N\r\n[✅成功/❌失败/⚠️部分] -- [具体证据]\r\n→ [v5.16.0 新增] 重试计数：N（若失败，则+1）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 📍 [ADVANCE] - 步骤 N\r\n推进：[继续步骤 N+1 / 重试 / 换方案 / 任务完成 / 求助]\r\n→ [v5.16.0 新增] 若换思路：原封不动推送到 REVIEW（不确认执行）\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ N │ ... │ ... │ ... │ ... │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：N/Total（X%）▸ 下一：步骤 N+1\r\n```\r\n\r\n### 状态标记规则\r\n\r\n| 标记 | 含义 | 说明 |\r\n|------|------|------|\r\n| ⏳ | 待执行 | 初始状态 |\r\n| 🔄 | 执行中 | 正在执行 |\r\n| ✅ | 成功 | 审查通过 |\r\n| ❌ | 失败 | 需要重试或换方案 |\r\n| ⏭️ | 跳过 | 经评估无需执行 |\r\n| 🔁 | 重试中 | 正在重试（重试计数 由 `permission_checker.py` 扫描生成（2026-05-24），扫描 8 个文件、3219 行。\r\n\r\n## 扫描结果摘要\r\n\r\n| 项目 | 值 |\r\n|------|-----|\r\n| 风险等级 | **MEDIUM** |\r\n| 权限权重 | **50.00%** |\r\n| 扫描文件数 | 8 |\r\n| 扫描行数 | 3219 |\r\n| 问题总数 | 28 |\r\n\r\n## 权限统计\r\n\r\n| 权限类型 | 次数 | 权重 |\r\n|---------|------|------|\r\n| `sensitive_access` | 0 | 40% |\r\n| `critical_write` | 0 | 30% |\r\n| `network_access` | 1 | 20% |\r\n| `file_delete` | 6 | 10% |\r\n| `subprocess_call` | 21 | — |\r\n\r\n## 高权限操作清单\r\n\r\n### subprocess_call（21 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/cron_helper.py` | 17, 43 | `subprocess` | `immediate` |\r\n| `scripts/exec_wrapper.py` | 32, 167, 180, 187, 195 | `subprocess` | `immediate` |\r\n| `scripts/install.py` | 85, 88, 126, 214 | `subprocess` / `exec(` | `immediate` |\r\n| `scripts/lessons_register.py` | 18, 60, 83 | `subprocess` | `immediate` |\r\n| `scripts/problem_daemon.py` | 27, 160, 413, 416, 417, 439 | `subprocess` / `Popen` | `immediate` |\r\n\r\n### file_delete（6 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/install.py` | 76, 189 | `shutil.rmtree` | `immediate` |\r\n| `scripts/ttask_progress.py` | 439, 443, 496, 501 | `os.remove` | `immediate` |\r\n\r\n### network_access（1 处，MEDIUM）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/settings.py` | 25 | `urllib` | `unified` |\r\n\r\n## 授权方式说明\r\n\r\n| 方式 | 适用场景 | 说明 |\r\n|------|----------|------|\r\n| `unified` | 中风险操作（network_access） | 批量统一授权，首次确认后可复用 |\r\n| `immediate` | 高风险操作（subprocess_call、file_delete） | 每次执行前需用户确认 |\r\n| `silent` | 低风险操作 | 无需授权，静默执行 |\r\n\r\n## 风险结论\r\n\r\n- **风险等级：MEDIUM**（权重 50%）\r\n- **建议**：高权限操作（subprocess、文件删除）已标注 `immediate` 授权方式，符合规范；网络访问（`settings.py`）使用 `unified` 授权，符合规范。\r\n- **R-15 检查**：所有高权限操作前均应有授权检查逻辑。\n\nFile v5.17.3:references/reference.md\n\n# reference.md — CLI 命令速查、进度文件、问题记录、数据目录、安装\r\n\r\n> 本文件包含 triphasic-execution 的完整命令参考和配置说明，供需要时加载。\r\n\r\n---\r\n\r\n## 临时进度文件机制\r\n\r\n> **[MANDATORY]** 违反 F-03/F-07/F-09 属于严重违规。\r\n\r\n### 核心原理\r\n\r\n```\r\n任务规划确认\r\n └─→ [MANDATORY] 创建临时进度文件（init）\r\n │\r\n ├─ 步骤1 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n ├─ 步骤2 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n │ ...\r\n └─ 任务完成 → [MANDATORY] 删除进度文件（complete）\r\n 中断/异常 → 保留文件，下次 resume 恢复\r\n```\r\n\r\n### AI 调用时机（[MANDATORY]）\r\n\r\n| 时机 | 必须调用的命令 |\r\n|------|----------------|\r\n| 任务规划确认后 | `init` |\r\n| 每个步骤 ADVANCE 后 | `update --step N --status success/failed --review \"...\" --advance \"...\"` |\r\n| 任务全部完成后 | `complete` |\r\n| 用户说\"继续\"、\"恢复\" | `resume` |\r\n| 用户说\"取消任务\"、\"停止\" | `abort --reason \"...\"` |\r\n\r\n### 命令速查\r\n\r\n```bash\r\n# [MANDATORY] 初始化（任务规划确认后立即调用）\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"任务名\" \\\r\n --purpose \"任务目的\" \\\r\n --requirements \"具体要求\" \\\r\n --risks \"潜在风险\" \\\r\n --steps '[{\"description\":\"步骤描述\",\"purpose\":\"步骤目的\",\"tool\":\"工具名\"}]'\r\n\r\n# [MANDATORY] 更新步骤状态（每步 ADVANCE 后调用）\r\npython {SKILL_DIR}/scripts/task_progress.py update \\\r\n --task \"任务名\" \\\r\n --step 1 \\\r\n --status success \\\r\n --review \"审查结论\" \\\r\n --advance \"推进决策\"\r\n\r\n# 恢复中断任务\r\npython {SKILL_DIR}/scripts/task_progress.py resume --task \"任务名\"\r\n\r\n# [MANDATORY] 完成任务（删除进度文件）\r\npython {SKILL_DIR}/scripts/task_progress.py complete --task \"任务名\"\r\n\r\n# 中止任务\r\npython {SKILL_DIR}/scripts/task_progress.py abort --task \"任务名\" --reason \"原因\"\r\n\r\n# 列出活跃任务\r\npython {SKILL_DIR}/scripts/task_progress.py list\r\n\r\n# 清理已完成/中止文件\r\npython {SKILL_DIR}/scripts/task_progress.py clean\r\n```\r\n\r\n---\r\n\r\n## 问题、风险、经验记录\r\n\r\n### [MANDATORY] 强制记录规则\r\n\r\n> 每次任务执行完成后，**[MANDATORY]** AI 必须执行以下步骤（除非用户明确选择\"2.跳过记录\"）：\r\n> 1. 回顾执行过程，识别问题 → 调用 `add`\r\n> 2. 回顾执行过程，识别风险 → 调用 `add-risk`\r\n> 3. 执行完成后 → 调用 `merge-to-lessons`\r\n\r\n### 问题记录\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add \\\r\n --scene \"API 测试\" \\\r\n --symptom \"HTTP 503\" \\\r\n --cause \"服务端限流\" \\\r\n --solution \"增加重试机制\" \\\r\n --task \"用户头像接口\"\r\n```\r\n\r\n### 风险记录\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add-risk \\\r\n --description \"网络不稳定可能导致 API 调用失败\" \\\r\n --impact \"用户体验下降\" \\\r\n --mitigation \"增加重试机制和降级策略\" \\\r\n --task \"用户头像接口\"\r\n```\r\n\r\n### 经验积累\r\n\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r\n```\r\n\r\n---\r\n\r\n## 配置界面\r\n\r\n安装技能后首次运行 `install.py` 时，会自动弹出 HTML 配置界面（系统默认浏览器），引导用户完成初始配置。\r\n\r\n| 配置项 | 选项 | 说明 |\r\n|---|---|---|\r\n| **默认调用方式** | 调用模式（按需） / 全局模式 | 控制技能激活方式 |\r\n| **记录文件路径** | TRIPHASIC_HOME 等 | 未自定义时使用默认值 |\r\n| **任务规划确认** | 询问确认后再执行 / 直接执行 | 控制 Agent 是否请求确认 |\r\n\r\n**当前配置**：\r\n> **调用方式**：🟢 按需调用模式（默认）\r\n> **数据目录**：`skills/.standardization/triphasic-execution/data/`\r\n> **任务规划确认**：询问确认后再执行\r\n\r\n呼出配置界面：向 Agent 发送\"打开 triphasic 配置\"，或运行 `python {SKILL_DIR}/scripts/settings.py`\r\n\r\n---\r\n\r\n## 双模式设计\r\n\r\n| 维度 | 按需调用模式（默认） | 全局自动模式（可选） |\r\n|---|---|---|\r\n| **触发条件** | 用户主动加载技能 | 配置 `mode: global` + 启动 daemon |\r\n| **记录行为** | 调用时才记录三步框架 | 所有任务自动应用三步框架 |\r\n| **后台守护** | 不启动 daemon | `problem_daemon.py` 持续监控 |\r\n| **适用场景** | 日常简单任务、跨平台协作 | 复杂多步骤项目、长期维护 |\r\n\r\n---\r\n\r\n## 数据目录\r\n\r\n| 路径 | 说明 |\r\n|------|------|\r\n| `TRIPHASIC_HOME/.problem_logs/problems.jsonl` | 问题日志 |\r\n| `TRIPHASIC_HOME/.problem_logs/risks.jsonl` | 风险日志 |\r\n| `TRIPHASIC_HOME/PROBLEMS.md` | 问题清单（人类可读） |\r\n| `TRIPHASIC_HOME/RISKS.md` | 风险手册 |\r\n| `TRIPHASIC_HOME/LESSONS_REGISTER.md` | 经验教训登记册 |\r\n| `TRIPHASIC_HOME/.active_tasks/` | 临时进度文件目录 |\r\n| `TRIPHASIC_HOME/config.json` | 用户配置 |\r\n\r\n---\r\n\r\n## 安装\r\n\r\n```bash\r\npython install.py # 基础安装\r\npython install.py --mode global # 全局自动模式\r\npython install.py --target ~/.workbuddy/skills/ # 指定安装路径\r\npython install.py --home ~/.myagent/triphasic/ # 指定数据目录\r\npython install.py --uninstall # 卸载\r\n```\r\n\r\n---\r\n\r\n## 脚本清单\r\n\r\n| 脚本 | 功能 |\r\n|------|------|\r\n| `install.py` | 安装/卸载 |\r\n| `settings.py` | HTML 配置界面 |\r\n| `problem_logger.py` | 问题/风险 CRUD + 合并登记册 |\r\n| `exec_wrapper.py` | 命令执行拦截器 |\r\n| `problem_daemon.py` | 后台监控守护进程（仅全局模式） |\r\n| `lessons_register.py` | 登记册管理 |\r\n| `cron_helper.py` | 定时任务钩子 |\r\n| `task_progress.py` | 临时进度文件管理（init/update/resume/complete/abort/clean） |\r\n\r\n所有脚本零外部依赖，仅使用 Python 标准库。跨平台支持 Windows/Linux/macOS。\r\n\r\n---\r\n\r\n## 权限权重说明（R-16）\r\n\r\n本技能各操作的权限权重评估如下（由 `skill-standardization/scripts/permission_checker.py` 计算）：\r\n\r\n| 脚本 | 操作类型 | 权限权重 | 风险等级 | 说明 |\r\n|------|---------|---------|---------|------|\r\n| `task_progress.py` | 读写 `.active_tasks/*.json` | 中低 | 🟡 | 仅读写本地进度文件，无外部命令调用 |\r\n| `problem_logger.py` | 读写 `.problem_logs/*.jsonl`、合并登记册 | 中 | 🟡 | 本地日志文件写入，无网络/外部命令 |\r\n| `settings.py` | 读/写 `config.json`，启动 HTTP 服务 | 中 | 🟡 | 本地配置读写，HTTP 仅本地 `localhost` |\r\n| `install.py` | 创建目录、写配置文件、注册守护进程 | 中高 | 🟠 | 涉及目录创建和配置写入，无系统级操作 |\r\n| `problem_daemon.py` | 后台守护进程，监控任务执行 | 中 | 🟡 | 仅本地监控，无外部访问 |\r\n| `exec_wrapper.py` | 拦截命令执行，记录问题 | 中高 | 🟠 | 涉及命令执行拦截，但仅记录不更新 |\r\n| `lessons_register.py` | 读写 `LESSONS_REGISTER.md` | 低 | 🟢 | 仅本地文件读写 |\r\n| `cron_helper.py` | 定时任务钩子 | 中低 | 🟡 | 仅本地定时任务管理 |\r\n\r\n**合计权限权重**：中（所有脚本均无高风险操作）\r\n**敏感信息访问**：无（仅本地文件读写）\r\n**关键位置写入**：否（仅写入技能自身 `data/` 和 `.active_tasks/` 目录）\r\n**高权限操作**：无（无需授权）\r\n\r\n> 本技能整体风险等级：**低至中等**。所有写入操作仅限于本地用户目录，不涉及系统目录、敏感位置或网络传输。命令行拦截器（`exec_wrapper.py`）仅做记录和监控，不更新原始命令。\n\nFile v5.17.3:skill-card.md\n\n## Description:
\nTriphasic Execution provides an Execute-Review-Advance workflow for structured task planning, progress tracking, retry limits, idle-loop limits, and issue or lesson logging.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[ldxs001](https://clawhub.ai/user/ldxs001)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and agent operators use this skill to keep complex work inside a structured execution loop with explicit planning, review, advancement decisions, and persistent task records. It is also used to record problems, risks, and lessons learned during multi-step work.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Optional command interception, background monitoring, and persistent command-output logging can capture secrets, tokens, file contents, or private command history.
\nMitigation: Use the default on-demand mode unless persistent monitoring is required, avoid enabling the exec wrapper for sensitive sessions, and review stored logs before sharing or retaining them.
\nRisk: Global mode and daemon monitoring broaden the skill from a task workflow helper into persistent local activity tracking.
\nMitigation: Enable global mode only after explicit user approval and periodically inspect or disable daemon-related configuration.
\nRisk: Cleanup and uninstall commands can delete the skill's own local records.
\nMitigation: Treat cleanup operations as destructive for TRIPHASIC_HOME data and back up records that must be retained.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/ldxs001/triphasic-execution)
\n- [Mandatory workflow rules](references/mandatory.md)
\n- [Command reference](references/reference.md)
\n- [Usage examples](references/examples.md)
\n- [Permission report](references/permissions.md)
\n- [Changelog](references/changelog.md)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown with inline shell commands and JSON configuration snippets]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May create or update local progress, problem, risk, lesson, and configuration records under TRIPHASIC_HOME when its scripts are used.]
\n\n## Skill Version(s):
\n5.17.3 (source: frontmatter and server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v5.17.1: 21 files, 60431 bytes\n\nFiles: _meta.json (139b), references/antipatterns.md (4120b), references/changelog.md (5030b), references/examples.md (5862b), references/faq.md (5594b), references/mandatory.md (18649b), references/permission_report.json (11592b), references/permissions.md (2305b), references/reference.md (7745b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (20297b), scripts/task_progress.py (33739b), skill-card.md (2636b), SKILL.md (11226b), temp_progress/active/脚本使用文档化.json (2919b), temp_progress/completed/skill-standardization-3fixes_summary.json (768b), temp_progress/completed/skill-standardization-3fixes.json (3756b)\n\nFile v5.17.1:SKILL.md\n\n---\r\nname: triphasic-execution\r\nversion: 5.17.1\r\nauthor: wUwproject\r\nlicense: MIT\r\ndescription: Execute→Review→Advance 三步循环执行框架 v5.17.1。增强步骤规划能力（参考 skill-sub 逻辑）、增强语义理解（参考 semantic-split 逻辑）；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。v5.17.1：数据目录从 ~/.workbuddy/triphasic/ 迁移到 ~/.workbuddy/.standardization/triphasic-execution/（符合R-11/R-12）；cmd_add 同步写 PROBLEMS.md；SKILL.md 新增强制输出协议；task_progress.py complete 路径修正。\r\ntags: ['framework', 'execution', 'debugging', 'problem-tracking', 'risk-tracking', 'lessons-learned', 'cross-platform', 'configuration', 'config-ui']\r\ncategory: workflow\r\ntrigger_negative: true\r\nsensitive_access: false\r\ncritical_write: false\r\ncreate_permissions_md: true\r\npermission_weight: LOW\r\nsection_antipattern: true\r\nsection_faq: true\r\ndata_dir: ../.standardization/triphasic-execution/\r\nexternal_data_dir: true\r\n---\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n# Triphasic Execution Framework v5.17.1\r\n\r\n执行 → 审查 → 推进。每次交互只做一件事，三者缺一不可。\r\n\r\n---\r\n\r\n## 触发条件\r\n\r\n**正向触发（满足以下任意一条）：**\r\n\r\n- 说出\"三步执行\"、\"执行审查推进\"、\"triphasic\"\r\n- 说出\"问题记录\"、\"经验教训\"、\"problem logger\"\r\n- 说出\"打开 triphasic 配置\"、\"triphasic config\"\r\n- 需要结构化执行框架防止死循环或跳步\r\n- 复杂多步骤任务，需要强制进度追踪和中断恢复\r\n\r\n**否定条件（满足以下任意一条，不触发）：**\r\n\r\n- 简单问答、闲聊、问候（不需要结构化执行）\r\n- 单步任务（如\"查看文件\"、\"运行命令\"等一步完成的操作）\r\n- 用户明确说\"不要使用 triphasic\"或\"关闭 triphasic\"\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n\r\n---\r\n\r\n## 核心能力\r\n\r\n> 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。\r\n\r\n| # | 能力 | 说明 |\r\n|---|------|------|\r\n| 1 | **语义理解增强（F-01+）** | 参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力；详见 `references/mandatory.md` Phase 0 |\r\n| 2 | **步骤规划增强（F-02+）** | 参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）；详见 `references/mandatory.md` Phase 1 |\r\n| 3 | **三步循环执行** | Execute→Review→Advance，每步必须完整，不可跳过 |\r\n| 4 | **进度文件持久化（F-03/F-07/F-09）** | init→update→complete，中断后可 resume 恢复；**complete 强制校验（v5.12）** |\r\n| 5 | **问题/风险/经验记录** | 任务完成后强制记录（复杂任务 Python 侧校验），积累 PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md |\r\n| 6 | **最多 3 次重试（F-08）** | 同一步骤失败 3 次必须换方案，禁止第 4 次重试 |\r\n| 7 | **最多 3 次空转（F-11）** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，禁止第 4 次空转 |\r\n| 8 | **双模式支持** | 按需调用模式（默认）/ 全局自动模式 |\r\n| 9 | **HTML 配置界面** | `settings.py` 可视化配置技能参数 |\r\n\r\n---\r\n\r\n## 空转/重试/换思路/求助 流转规则\r\n\r\n> 详细规则见 `references/mandatory.md` Phase 2~4。\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n```bash\r\n# 按需调用（默认）— 任务开头说出关键词即可\r\n\"使用 triphasic-execution 执行以下任务：...\"\r\n\r\n# 全局自动模式 — 所有任务自动套用框架\r\n编辑 data/default_config.json → \"mode\": \"auto\"\r\n\r\n# 可视化配置\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## ⚡ [LOADING PROTOCOL]\r\n\r\nskill 加载后，AI 输出以下状态标识：\r\n\r\n```\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n```\r\n\r\n| 观察结果 | 结论 |\r\n|---------|------|\r\n| 状态输出在任务相关内容之前出现 | ✅ 执行顺序正确 |\r\n| 状态输出在任务执行后才出现 | ❌ 执行顺序错误 |\r\n| 无状态输出 | ❌ skill 未加载 |\r\n\r\n---\r\n\r\n## 🚨 [MANDATORY] 强制约束总表\r\n\r\n> **本节是整个技能的执行宪法。违反任意一条 = 违规，必须立即停止并补救。**\r\n\r\n| 序号 | 约束内容 | 触发时机 | Python 强制 |\r\n|------|---------|---------|------------|\r\n| **F-01** | 收到任务后首先执行语义拆分，禁止直接进入规划 | 收到任务第一个响应 | ❌ AI 自觉 |\r\n| **F-02** | 语义拆分完成后必须输出【任务规划】，禁止直接执行 | 语义拆分输出后 | ❌ AI 自觉（需用户确认规划）|\r\n| **F-03** | 任务规划输出后立即调用 `task_progress.py init` | 规划确认后 | ✅ 文件不存在则后续 update/complete 报错 |\r\n| **F-04** | 每步 EXECUTE 开始前重述本步骤任务目的 | 每步执行前 | ❌ AI 自觉 |\r\n| **F-05** | 每步执行后必须紧跟 REVIEW，禁止连续执行两步 | 每步执行后 | ❌ AI 自觉 |\r\n| **F-06** | 每步 REVIEW 后必须紧跟 ADVANCE | 每步 REVIEW 后 | ❌ AI 自觉 |\r\n| **F-07** | 每步 ADVANCE 后调用 `task_progress.py update` | 每步 ADVANCE 后 | ✅ update 校验 init 存在性 |\r\n| **F-08** | 同一步骤失败 3 次后必须换方案，禁止第 4 次重试 | 重试计数达到 3 | ⚠️ 部分（update 记录重试次数）|\r\n| **F-09** | 任务完成后调用 `task_progress.py complete` | 任务完成时 | ✅ **v5.12 强制**：校验步骤完成率、记录文件、summary.json |\r\n| **F-10** | 任务完成后必须输出【任务完成】总结 | 任务结束时 | ⚠️ 部分（summary.json 自动生成）|\r\n| **F-11** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入 | 空转计数达到 3 | ❌ AI 自觉（截断后等待用户输入触发词重新激发）|\r\n| **F-12** | 换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环 | 换思路请求产生时 | ❌ AI 自觉（换思路也走完整三步）|\r\n| **F-13** | 推进阶段成功后，坚决不倒回已画√的步骤 | 推进决策时 | ❌ AI 自觉 |\r\n\r\n### 自检指令\r\n\r\n```\r\n[自检] 当前阶段：[阶段名称]\r\n- F-01 语义拆分：[已完成/待执行]\r\n- F-02 任务规划：[已完成/待执行]\r\n- F-03 进度文件创建：[已完成/待执行]\r\n- 当前步骤 N：[待执行/执行中/已完成]\r\n- 重试计数：[0/1/2/3/超次]\r\n- 空转计数：[0/1/2/3/超次]\r\n违规项：[无/F-XX 描述]\r\n```\r\n\r\n---\r\n\r\n## 工作流程\r\n\r\n```\r\n用户任务\r\n ↓ [F-01 MANDATORY]\r\n语义拆分 → 输出块分析（主语/目的/诉求/动机）[增强：5W2H + 约束标注]\r\n ↓ [F-02 MANDATORY]\r\n任务规划 → 明确目的/要求/工具/结果/风险 → 确认执行 [增强：参考 skill-sub 规划逻辑]\r\n ↓ [F-03 MANDATORY]\r\ntask_progress.py init → 创建进度文件\r\n ↓\r\n执行循环（每步骤）：\r\n 🔧 EXECUTE（重述目的 → 执行）[空转计数]\r\n ↓ [F-05]\r\n 🔍 REVIEW（✅/❌/⚠️ + 证据）[重试计数/空转计数]\r\n ↓ [F-06]\r\n 📍 ADVANCE（继续/换方案/求助/完成）[截断/触发词重启]\r\n ↓ [F-07]\r\n task_progress.py update\r\n ↓\r\n任务完成\r\n ↓ [F-09] task_progress.py complete\r\n ↓ [F-10] 输出【任务完成】总结\r\n ↓ [MANDATORY] 问题/风险/经验记录\r\n```\r\n\r\n### 🔴 任务完成后的强制输出协议（AI 必读）\r\n\r\n> **每完成一个任务后，AI 必须执行以下 3 步，不可跳过。**\r\n> 不管任务成败，只要有实际工作产出，就必须记录。\r\n\r\n| 步骤 | 命令 | 说明 |\r\n|------|------|------|\r\n| 1 | `task_progress.py complete --task \"名称\"` | 完成任务，强制校验记录文件 |\r\n| 2 | `problem_logger.py add --scene \"场景\" --symptom \"现象\" --cause \"原因\" --solution \"方案\" --task \"任务\"` | 每遇到一个非 trivial 问题都记录 |\r\n| 3 | `problem_logger.py merge-to-lessons` | 任务完全完成后，合并所有待合并条目到 LESSONS_REGISTER.md |\r\n\r\n→ 完整用法见下方「快速命令」章节\r\n→ 数据目录：`~/.workbuddy/.standardization/triphasic-execution/`（符合 R-11/R-12 规范）\r\n\r\n→ 详细规则、模板、禁止行为清单见 `references/mandatory.md`\r\n→ 完整示例见 `references/examples.md`\r\n→ CLI 命令、进度文件、数据目录、安装见 `references/reference.md`\r\n\r\n---\r\n\r\n## 循环规则（摘要）\r\n\r\n1. **语义拆分先行** — 收到任务的第一个动作（增强：5W2H + 约束强度标注）\r\n2. **规划先行** — 所有任务必须先输出任务规划（增强：参考 skill-sub 规划逻辑）\r\n3. **临时文件持久化** — init → update（每步）→ complete\r\n4. **最小单元** — 单次工具调用，每步立即审查+推进\r\n5. **最多 3 次重试** — 3 次失败后必须换方案\r\n6. **最多 3 次空转** — 3 次空转后必须截断并请求触发词输入\r\n7. **大任务才拆分** — 3步以上输出步骤列表\r\n8. **中断可恢复** — 进度文件保留，重启后 resume\r\n9. **换思路走完整三步** — 禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 快速命令\r\n\r\n```bash\r\n# 进度文件\r\npython {SKILL_DIR}/scripts/task_progress.py init --task \"名称\" --purpose \"目的\" --requirements \"要求\" --risks \"风险\" --steps '[...]'\r\npython {SKILL_DIR}/scripts/task_progress.py update --task \"名称\" --step 1 --status success --review \"...\" --advance \"...\"\r\npython {SKILL_DIR}/scripts/task_progress.py complete --task \"名称\" # --force 跳过步骤检查；--no-enforce 关闭记录校验\r\npython {SKILL_DIR}/scripts/task_progress.py resume --task \"名称\"\r\n\r\n# 问题/风险/经验\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"场景\" --symptom \"症状\" --cause \"原因\" --solution \"方案\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py add-risk --description \"风险\" --impact \"影响\" --mitigation \"缓解\" --task \"任务\"\r\npython {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r\n\r\n# 配置界面\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## 渐进式 MD 文件体系\r\n\r\n| 本文件（SKILL.md）包含 | 拆分到 references/ |\r\n|---|---|\r\n| ✅ 触发条件、核心能力、强制约束总表 | 📄 `mandatory.md` — Phase 0~4 详细规则、模板、禁止行为、空转/重试/换思路流转 |\r\n| ✅ 工作流程概述、循环规则 | 📄 `examples.md` — 完整执行示例（含空转/重试/换思路场景） |\r\n| ✅ 快速命令 | 📄 `reference.md` — 进度文件机制、问题记录、安装、数据目录 |\r\n| | 📄 `antipatterns.md` — 反模式收录（AP-01~AP-08） |\r\n| | 📄 `faq.md` — 常见问题（Q&A 1~12） |\r\n\r\n---\r\n\r\n## 版本\r\n\r\n当前版本：**5.17.1** — v5.17.1：数据目录迁移到 .standardization/triphasic-execution/；cmd_add 同步写 PROBLEMS.md；SKILL.md 新增强制输出协议；task_progress.py complete 路径修正。\n\nFile v5.17.1:_meta.json\n\n{\n \"ownerId\": \"kn75zfd51df61ajdyqtgvrs1hx84s4q6\",\n \"slug\": \"triphasic-execution\",\n \"version\": \"5.17.1\",\n \"publishedAt\": 1779987893830\n}\n\nFile v5.17.1:references/antipatterns.md\n\n# Triphasic Execution - 反模式（Antipatterns）\r\n\r\n本文档收录使用本技能时的常见错误和注意事项。\r\n\r\n---\r\n\r\n## 反模式列表\r\n\r\n### ❌ AP-01：跳过语义拆分直接规划\r\n\r\n**错误做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[直接输出任务规划]\r\n```\r\n\r\n**正确做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[首先输出语义拆分]\r\n - 主语：用户\r\n - 目的：修复 bug\r\n - 诉求：定位并修复代码错误\r\n - 动机：恢复功能正常\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-02：跳过审查直接推进\r\n\r\n**错误做法：**\r\n```\r\nEXECUTE → [无 REVIEW] → ADVANCE\r\n```\r\n\r\n**正确做法：**\r\n```\r\nEXECUTE → REVIEW（✅/❌/⚠️ + 证据）→ ADVANCE\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-03：同一步骤无限重试\r\n\r\n**错误做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 重试\r\n第 4 次失败 → 重试（❌ 违反 F-08）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 换方案（✅ 遵守 F-08）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-04：进度文件未创建就执行\r\n\r\n**错误做法：**\r\n```\r\n任务规划 → [无 ttask_progress.py init] → 直接执行\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务规划 → ttask_progress.py init → 执行（✅ 遵守 F-03）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-05：任务完成未调用 complete\r\n\r\n**错误做法：**\r\n```\r\n任务执行完 → [无 ttask_progress.py complete] → 结束\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务执行完 → ttask_progress.py complete → 输出总结（✅ 遵守 F-09）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-06：中英文混排缺少空格\r\n\r\n**错误做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n**正确做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-07：空转超过 3 次未截断（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n第 1 次空转 → 继续\r\n第 2 次空转 → 继续\r\n第 3 次空转 → 继续\r\n第 4 次空转 → 继续（❌ 违反 F-11）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次空转 → 重述规划，明确要求必须执行\r\n第 2 次空转 → 重述规划，明确要求必须执行\r\n第 3 次空转 → 主动截断，请求用户输入触发词（✅ 遵守 F-11）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-08：换思路时三步骤内部直接循环（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n换思路 → 直接执行新方案（❌ 跳过 REVIEW→ADVANCE）\r\n换思路 → 直接推进（❌ 跳过 EXECUTE→REVIEW）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n换思路 → 原封不动推送到 REVIEW\r\n ↓\r\n REVIEW（记录换思路，不确认执行）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步循环）（✅ 遵守 F-12）\r\n```\r\n\r\n---\r\n\r\n## 注意事项\r\n\r\n1. **语义拆分是强制的** — 收到任务第一个动作必须是语义拆分，不能跳过\r\n2. **规划必须用户确认** — F-02 要求规划输出后需用户确认才能执行\r\n3. **三步循环不可跳过** — Execute→Review→Advance 缺一不可\r\n4. **进度文件必须创建** — F-03 强制要求 init，否则后续 update/complete 会报错\r\n5. **最多 3 次重试** — F-08 强制要求，第 4 次必须换方案\r\n6. **最多 3 次空转** — F-11 强制要求，第 4 次必须截断并请求触发词输入\r\n7. **换思路必须走完整三步** — F-12 强制要求，禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 常见问题排查\r\n\r\n| 问题 | 原因 | 解决方案 |\r\n|------|------|----------|\r\n| `ttask_progress.py update` 报错 | 未执行 `init` | 先执行 `ttask_progress.py init` |\r\n| `complete` 校验失败 | 步骤完成率不足 | 检查哪些步骤未标记为 success |\r\n| 重试次数超限 | 同一方案失败 3 次 | 换方案，禁止第 4 次重试 |\r\n| 进度文件丢失 | 误删除或路径错误 | 重新执行 `init`，或手动创建进度文件 |\n\nFile v5.17.1:references/changelog.md\n\n# triphasic-execution 版本更新日志\r\n## v5.17.0（2026-05-28）\r\n\r\n**改写类型：标准化改造 — 修复 R-11/R-20/R-23 违规**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-11 产出物路径违规：`assets/` 和 `temp_progress/` 迁至 `skills/.standardization/triphasic-execution/data/`\r\n- ✅ 修复 R-20 写作规范：`ttask_progress.py`（双t typo）→ `task_progress.py`；中英文混排补空格\r\n- ✅ 修复 R-22/R-23 文档-代码一致性：`SKILL.md`/`faq.md`/`examples.md`/`reference.md` 路径引用全部修正\r\n- ✅ 新增 frontmatter 字段：`data_dir: ../.standardization/triphasic-execution/`、`external_data_dir: true`\r\n- ✅ `assets/default_config.json` → `data/default_config.json`；`assets/settings.html` → `data/settings.html`\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 0 ERROR 0 WARN（剩余 2 WARN 为审计工具误报，非真实违规）\r\n- 数据目录合规，符合 R-11/R-12/R-22 规范\r\n\r\n---\r\n\r\n\r\n---\r\n\r\n## v5.16.0（2026-05-28）\r\n\r\n**改写类型：功能增强 — 规划能力增强 + 执行验证机制 + 强制约束落脚本**\r\n\r\n### 更新内容\r\n\r\n- ✅ 增强语义理解（F-01+）：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），Phase 0 新增注意力锚定、自我反查\r\n- ✅ 增强步骤规划（F-02+）：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），Phase 1 新增规划逻辑说明（非调用链，仅参考逻辑）\r\n- ✅ 新增 F-11：同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，由 `ttask_progress.py --idle` 脚本级强制\r\n- ✅ 新增 F-12：换思路必须经 ADVANCE→EXECUTE→REVIEW→ADVANCE 完整循环，禁止三步骤内部直接循环\r\n- ✅ 新增 F-13：推进阶段成功后，坚决不倒回已画√的步骤\r\n- ✅ `ttask_progress.py` 新增字段：`idle_count`、`executed_proof`、`snapshot_before`、`snapshot_after`\r\n- ✅ `ttask_progress.py` 新增子命令：`pre_exec`（执行前文件快照）、`verify_exec`（执行后验证文件变化）\r\n- ✅ `ttask_progress.py` 新增参数：`--idle`、`--verify-execution`、`--proof`、`--clear-cache`、`--trigger-word`\r\n- ✅ `ttask_progress.py` F-08/F-11 强制约束由脚本实现（≥3次 `sys.exit(1)`），不再靠 AI 自觉\r\n- ✅ `_clear_tool_cache()` 清除 `__pycache__`/`.pyc` 等缓存，避免验证误判\r\n- ✅ `mandatory.md` Phase 2~4 新增完整空转/重试/换思路/求助流转规则\r\n- ✅ `antipatterns.md` 新增 AP-07（空转超3次未截断）、AP-08（换思路时三步骤内部直接循环）\r\n- ✅ `faq.md` 新增 Q11（什么是空转）、Q12（换思路为什么要走完整三步循环）\r\n- ✅ 修复 `_meta.json` 版本号描述拼写错误\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计预期 0 ERROR 0 WARN\r\n- 空转/重试约束从\"AI 自觉\"升级为\"脚本强制\"\r\n- 执行验证支持文件系统级证据（mtime + hash 对比）\r\n\r\n---\r\n\r\n## v5.15.0（2026-05-25）\r\n\r\n**改写类型：Bug 修复 — R-20 术语不一致 + 中英文混排 + 拼写错误**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-20 术语不一致（\"配置\" → \"配置\"、\"更新\" → \"更新\"）\r\n- ✅ 修复 R-20 中英文混排缺少空格（\"Bug\" → \"Bug \"、\"Token\" → \"Token \" 等）\r\n- ✅ 修复拼写错误（`tAsk_progress.py` → `ttask_progress.py`）\r\n- ✅ 修复 `## 核心能力` 章节渐进式加载说明（通过 R-21 检查）\r\n- ✅ 修复触发条件否定条件（添加单步任务不触发的说明）\r\n- 📦 更新 `_meta.json` 和 `SKILL.md` 版本号至 v5.15.0\r\n\r\n### 影响\r\n\r\n- triphasic-execution 审计 21/21 PASS（0 ERROR）\r\n- R-20 写作规范全面符合\r\n- 渐进式加载说明显式化\r\n\r\n---\r\n\r\n## v5.14.0（2026-05-24）\r\n\r\n**改写类型：skill-standardization refactor 正确改造**\r\n\r\n### 更新内容\r\n- ✅ 使用 `refactor` 模式正确改造（先 `--dry-run` 再实际执行）\r\n- ✅ 自动备份：`triphasic-execution_bak_refactor_20260524_230726`\r\n- ✅ 调用 `permission_checker.py` 扫描脚本权限（8 文件 / 3219 行）\r\n- ✅ 权限扫描结果：风险等级 MEDIUM，权重 50%，28 个问题（27 HIGH + 1 MEDIUM）\r\n- ✅ 生成 `references/permission.md`（基于扫描报告，非手写）\r\n- ✅ 生成 `references/permission_report.json`（机器可读）\r\n\r\n### 权限扫描摘要\r\n| 权限类型 | 次数 |\r\n|---------|------|\r\n| `subprocess_call` | 21 |\r\n| `file_delete` | 6 |\r\n| `network_access` | 1 |\r\n| `sensitive_access` | 0 |\r\n| `critical_write` | 0 |\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=16（全规则通过）\r\n\r\n---\r\n\r\n## v5.10.1（2026-05-23）\r\n\r\n**改写类型：skill-standardization 标准化审查**\r\n\r\n### 更新内容\r\n- 标准化审查通过，无需更新（R-01~R-11 全部合规）\r\n\r\n### 标准化审查结果\r\n- ERROR=0, WARN=0, PASS=5\r\n\r\n---\r\n\r\n## 版本历史\r\n\r\n> 详细版本历史参见 git 提交记录。\r\n> 标准化审查前的版本信息由 SKILL.md frontmatter `version` 和 git tag 追溯。\n\nFile v5.17.1:references/examples.md\n\n# examples.md — 完整执行流程示例\r\n\r\n> 本文件包含 triphasic-execution 的完整示例，供参考学习时加载。\r\n\r\n---\r\n\r\n## 示例：多步任务（标准完整流程）\r\n\r\n```\r\n用户：请帮我修复登录接口 Bug\r\n\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n\r\n[自检] 当前阶段：收到任务\r\n- F-01 语义拆分：待执行\r\n- F-02 任务规划：待执行\r\n违规项：无，执行语义拆分\r\n\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n请帮我修复登录接口 Bug\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：用户\r\n 角色：requester\r\n 目的：登录接口恢复正常\r\n 诉求：\r\n 1. 修复登录接口中的 Bug\r\n 动机：当前登录功能存在问题\r\n\r\n## 块 2：执行者\r\n 角色：executor\r\n 目的：定位并修复登录接口 Bug\r\n 诉求：\r\n 1. 读取代码定位问题\r\n 2. 修复代码\r\n 3. 验证修复有效\r\n 动机：块1的所有要求\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n\r\n【任务规划】修复登录接口 Bug\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞\r\n📋 具体要求：添加 Token 验证逻辑，确保未携带有效 Token 的请求被拒绝\r\n⚠️ 潜在风险：更新可能影响正常登录流程\r\n\r\n**执行步骤**：\r\n 步骤 1: 读取登录接口代码\r\n - 任务目的：获取当前代码，理解认证逻辑现状\r\n - 工具/命令：`Read`\r\n - 操作说明：读取 login.py 文件\r\n - 预期结果：获取完整代码内容\r\n - 潜在风险：文件不存在\r\n\r\n 步骤 2: 修复代码\r\n - 任务目的：添加缺失的 Token 验证逻辑\r\n - 工具/命令：`Edit`\r\n - 操作说明：在指定位置添加验证逻辑\r\n - 预期结果：代码更新成功，无语法错误\r\n - 潜在风险：语法错误、引入新 bug\r\n\r\n 步骤 3: 测试验证\r\n - 任务目的：验证修复有效且未影响正常功能\r\n - 工具/命令：`Bash`（pytest）\r\n - 操作说明：运行测试用例\r\n - 预期结果：测试通过\r\n - 潜在风险：测试环境问题\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]：\r\n → 问题记录 → 风险记录 → 经验积累\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r\n\r\n→ [MANDATORY-F-03] 创建进度文件：\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"修复登录 Bug\" \\\r\n --purpose \"修复 Token 验证缺失导致的认证绕过漏洞\" \\\r\n --requirements \"添加 Token 验证逻辑\" \\\r\n --risks \"可能影响正常登录\" \\\r\n --steps '[{\"description\":\"读取代码\",\"purpose\":\"理解认证逻辑\",\"tool\":\"Read\"},{\"description\":\"修复代码\",\"purpose\":\"添加验证\",\"tool\":\"Edit\"},{\"description\":\"测试验证\",\"purpose\":\"确认修复有效\",\"tool\":\"Bash\"}]'\r\n\r\n### 🔧 [EXECUTE] - 步骤 1\r\n🔧 执行前重述目的：获取当前代码，理解认证逻辑现状\r\n（读取 login.py...）\r\n\r\n### 🔍 [REVIEW] - 步骤 1\r\n✅成功 -- 发现 Token 验证逻辑缺失\r\n\r\n### 📍 [ADVANCE] - 步骤 1\r\n推进：继续步骤 2\r\n→ 更新进度文件：python {SKILL_DIR}/scripts/task_progress.py update --task \"修复登录 Bug\" --step 1 --status success --review \"发现 Token 验证缺失\" --advance \"继续步骤2\"\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：1/3（33%）▸ 下一：步骤2\r\n\r\n...（继续步骤 2-3）\r\n\r\n【任务完成】\r\n- 目标：修复登录接口 Bug\r\n- 结果：✅成功 -- Token 验证已添加\r\n- 进度：3/3（100%）\r\n→ [MANDATORY-F-09] python {SKILL_DIR}/scripts/task_progress.py complete --task \"修复登录 Bug\"\r\n```\n\nFile v5.17.1:references/faq.md\n\n# Triphasic Execution - 常见问题（FAQ）\r\n\r\n本文档收录使用本技能时的常见问题和解答。\r\n\r\n---\r\n\r\n## Q&A 列表\r\n\r\n### Q1：什么时候应该使用 triphasic-execution？\r\n\r\n**A：** 当任务满足以下任一条件时：\r\n- 多步骤任务（≥3 步）\r\n- 容易出现死循环或无限重试\r\n- 需要中断恢复能力\r\n- 需要结构化的问题/风险/经验记录\r\n\r\n**不适合的场景：**\r\n- 简单问答（单步即可完成）\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n- 用户明确要求不使用本技能\r\n\r\n---\r\n\r\n### Q2：语义拆分是什么？为什么要强制？\r\n\r\n**A：** 语义拆分是将用户任务拆解为结构化字段：\r\n- **主语**：谁发起的任务\r\n- **目的**：为什么要做这个任务\r\n- **诉求**：具体要做什么\r\n- **动机**：深层需求是什么\r\n\r\n**强制原因：** 防止 AI 误解任务意图，导致执行方向错误。\r\n\r\n---\r\n\r\n### Q3：F-02 要求规划必须用户确认，能不能跳过？\r\n\r\n**A：** 不能。F-02 是强制约束（用 ❌ AI 自觉 标记），必须输出规划并等待用户确认后才能执行。\r\n\r\n**例外：** 如果用户明确说\"直接执行\"、\"不需要确认\"，可以跳过，但需要在规划中说明。\r\n\r\n---\r\n\r\n### Q4：task_progress.py 有什么用？不用行不行？\r\n\r\n**A：** `task_progress.py` 用于持久化进度，支持中断恢复。F-03 强制要求调用 `init`，F-07 强制要求每步调用 `update`，F-09 强制要求任务完成时调用 `complete`。\r\n\r\n**不用的后果：**\r\n- 任务中断后无法恢复\r\n- 无法追踪步骤完成率\r\n- `complete` 校验会失败（v5.12+）\r\n\r\n---\r\n\r\n### Q5：同一步骤失败 3 次后必须换方案，能不能第 4 次重试？\r\n\r\n**A：** 不能。F-08 是强制约束，第 4 次重试违反规范。\r\n\r\n**正确做法：**\r\n- 第 1~3 次：尝试同一方案\r\n- 第 3 次失败后：换方案（完全不同思路）\r\n- 新方案再失败：继续换，直到任务完成或所有方案耗尽\r\n\r\n---\r\n\r\n### Q6：`complete` 校验失败怎么办？\r\n\r\n**A：** `complete` 校验检查以下内容：\r\n1. 步骤完成率（所有步骤必须标记为 success）\r\n2. 记录文件（PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md）\r\n3. summary.json（任务总结）\r\n\r\n**修复方法：**\r\n- 完成所有未完成的步骤\r\n- 运行 `problem_logger.py add` 记录问题/风险\r\n- 运行 `task_progress.py complete --force` 跳过步骤检查（不推荐）\r\n- 运行 `task_progress.py complete --no-enforce` 关闭记录校验（不推荐）\r\n\r\n---\r\n\r\n### Q7：按需调用模式和全局自动模式有什么区别？\r\n\r\n**A：**\r\n- **按需调用（默认）**：用户说出关键词（\"三步执行\"、\"triphasic\"等）才触发\r\n- **全局自动模式**：所有任务自动套用框架，无需关键词\r\n\r\n**切换方法：**\r\n编辑 `data/default_config.json` → `\"mode\": \"auto\"`\r\n\r\n---\r\n\r\n### Q8：settings.py 是干什么的？\r\n\r\n**A：** `settings.py` 是一个 HTML 可视化配置界面，用于配置技能参数（如模式、重试次数、记录文件路径等）。\r\n\r\n**运行方法：**\r\n```bash\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n### Q9：SKILL_DIR 是什么？为什么代码块里用这个变量？\r\n\r\n**A：** `SKILL_DIR` 是一个变量，表示技能安装目录（如 `~/.workbuddy/skills/triphasic-execution`）。\r\n\r\n**为什么用变量：** SKILL.md 是模板文件，实际路径由 AI 根据环境替换。\r\n\r\n**人工阅读时：** 看到 `{SKILL_DIR}` 请自动替换为实际路径。\r\n\r\n---\r\n\r\n### Q10：为什么我的任务被阻断了？\r\n\r\n**A：** 可能被以下约束阻断：\r\n- **F-01**：未输出语义拆分\r\n- **F-02**：未输出任务规划\r\n- **F-03**：未调用 `task_progress.py init`\r\n- **F-07**：未调用 `task_progress.py update`\r\n- **F-08**：同一步骤失败 3 次未换方案\r\n- **F-09**：未调用 `task_progress.py complete`\r\n\r\n**解决方法：** 检查 [自检指令] 输出，看哪个 F-XX 未通过。\r\n\r\n---\r\n\r\n### Q11：什么是\"空转\"？空转 3 次截断是什么意思？（v5.16.0 新增）\r\n\r\n**A：** 空转指 EXECUTE 阶段没有实际执行任何操作（仅输出描述、未调用工具），却进入了 REVIEW 阶段。\r\n\r\n**空转计数规则：**\r\n- 每次 EXECUTE 阶段未实际执行 → 空转计数 +1\r\n- 空转计数 ≤3 次 → 重述规划，明确要求必须执行\r\n- 空转计数 >3 次 → 主动截断，请求用户输入固定触发词打破空转\r\n\r\n**触发词：** `继续执行`（用户可自定义，见配置）\r\n\r\n---\r\n\r\n### Q12：换思路时为什么要走完整三步循环？（v5.16.0 新增）\r\n\r\n**A：** 换思路时如果直接执行或直接推进，会跳过 REVIEW 或 EXECUTE，导致三步循环断裂，属于违反 F-12。\r\n\r\n**正确流转：**\r\n```\r\n换思路产生 → 原封不动推送到 REVIEW（不确认执行）\r\n ↓\r\n REVIEW（记录换思路）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步）\r\n```\r\n\r\n**核心原则：** 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考。没有任何三步骤内部直接循环的情况。\r\n\r\n---\r\n\r\n## 其他问题\r\n\r\n如果这里没有你的问题，请运行：\r\n```bash\r\npython {SKILL_DIR}/scripts/problem_logger.py add --scene \"文档\" --symptom \"FAQ 缺少问题 XXX\" --cause \"未收录\" --solution \"补充到 faq.md\"\r\n```\n\nFile v5.17.1:references/mandatory.md\n\n# mandatory.md — 强制约束详细规则\r\n\r\n> 本文件包含 triphasic-execution 的完整强制约束内容，供需要深入了解规则细节时加载。\r\n\r\n---\r\n\r\n## Phase 0 —— 语义拆分完整规则（增强版 v5.16.0）\r\n\r\n> **违反 F-01：如果 AI 没有输出语义拆分就开始规划或执行，属于严重违规。必须回滚并先输出拆分结果。**\r\n> **v5.16.0 增强**：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力。\r\n\r\n### 拆分规则（增强版）\r\n\r\n**块（Block）识别**：按主语划分，每个主语构成一个块。\r\n\r\n| 主语类型 | 识别方式 |\r\n|---------|---------|\r\n| 用户（\"我\"） | 说话者本人 |\r\n| AI 助手（\"你\"） | 执行者、帮助者 |\r\n| 第三方（\"他/她/它\"） | 提及的其他角色 |\r\n\r\n**每个块提取三类信息：**\r\n\r\n| 元素 | 定义 | 增强标注 |\r\n|-----|------|---------|\r\n| **目的** | 最终要达成的目标 | 标注🔴🟡⚪约束强度 |\r\n| **诉求** | 需要执行的具体操作或交付物 | 硬约束🔴/软约束🟡/无约束⚪ |\r\n| **动机** | 为什么会产生这个需求 | 背景/原因/情绪 |\r\n\r\n### v5.16.0 新增：5W2H 维度提取（参考 semantic-split）\r\n\r\n**步骤 0.5**：任务类型识别与 5W2H 初始化（内部执行，不输出）\r\n\r\n1. **任务类型识别**：制作PPT / 填写周报 / 安排行程 / 写邮件 / 策划活动 / 其他\r\n2. **5W2H 维度初始化**：按任务类型从默认映射表填入默认值\r\n3. **约束强度预标注**：🔴硬约束 / 🟡软约束 / ⚪无约束\r\n\r\n**步骤 0.7**：注意力锚定（内部执行，不输出）\r\n\r\n1. `[CRITICAL]` — 硬约束，后续不可违反\r\n2. `[CORE]` — 核心目标（动词+宾语）\r\n3. `[ENTITY]` — 数字、时间、人名\r\n4. `[EXAMPLE]` — 举例内容，降权不作为约束\r\n5. `[RESISTANCE]` — 「但是/担心/难」后内容\r\n6. 核心句重构：「[主语] 要 [CORE] 于 [时间/场景]」（≤20字）\r\n\r\n### v5.16.0 新增：自我反查（内部执行，不输出）\r\n\r\n| 反查 | 检查内容 | 修正 |\r\n|------|---------|------|\r\n| 1 | 硬约束遗漏：`[CRITICAL]` 是否全在结果中？ | 补充 |\r\n| 2 | 约束误判：🟡 词被标为 🔴？ | 修正 |\r\n| 2b | 隐式升级：🟡 约束属组织规范/法律/安全？→ 🟡🔴 或 🔴 | 升级 |\r\n| 3 | 举例干扰：`[EXAMPLE]` 被当核心诉求？ | 降级 |\r\n| 4 | 5W2H 缺失：有明显可推断维度？ | 补充 `[推断]` |\r\n\r\n### 输出格式（[MANDATORY] 必须按此格式输出）\r\n\r\n```\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n[用户原话完整引用]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：[主语名称]\r\n 角色：[用户/执行者/第三方]\r\n 目的：[该主语要达成的核心目标] 🔴/🟡/⚪\r\n 诉求：\r\n 1. [诉求点1] 🔴/🟡/⚪\r\n 2. [诉求点2] 🔴/🟡/⚪\r\n 3. [诉求点3] 🔴/🟡/⚪\r\n 动机：[产生该需求的背景/原因/情绪]\r\n\r\n## 块 2：[主语名称]\r\n 角色：[执行者]\r\n 目的：[执行者要达成的目标]\r\n 诉求：\r\n 1. [需要执行的行为1]\r\n 2. [需要执行的行为2]\r\n 动机：[块1的所有要求]\r\n\r\n**5W2H 维度**：\r\n - Why（为什么）：[值] 🔴/🟡/⚪\r\n - What（做什么）：[值] 🔴/🟡/⚪\r\n - Who（谁参与）：[值] 🔴/🟡/⚪\r\n - Where（在哪里）：[值] 🔴/🟡/⚪\r\n - When（什么时候）：[值] 🔴/🟡/⚪\r\n - How（怎么做）：[值] 🔴/🟡/⚪\r\n - How much（多少）：[值] 🔴/🟡/⚪\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n```\r\n\r\n---\r\n\r\n## Phase 1 —— 任务规划完整模板（增强版 v5.16.0）\r\n\r\n> **违反 F-02：如果 AI 在输出【语义拆分】后没有输出【任务规划】就开始执行，属于严重违规。**\r\n> **v5.16.0 增强**：参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）。\r\n\r\n### 判断流程（增强版）\r\n\r\n```\r\n收到任务\r\n │\r\n ├─ [MANDATORY] 第零步：语义拆分（F-01，必做）[增强：5W2H + 约束标注]\r\n │ → 输出块分析：主语/目的/诉求/动机 + 5W2H维度 + 约束强度\r\n │\r\n ├─ [MANDATORY] 第一步：任务规划（F-02，必做，所有任务）[增强：参考skill-sub规划逻辑]\r\n │ → 明确：任务目的、具体要求、使用工具、预期结果、潜在风险\r\n │ → [增强] 步骤排序（参考skill-sub的意图理解→步骤排序逻辑）\r\n │ → [增强] 执行计划生成（参考skill-sub的执行计划生成逻辑）\r\n │\r\n ├─ 第二步：判断是否需要拆分\r\n │ ├─ 单步任务（1个操作可完成）→ 直接进入执行\r\n │ └─ 多步任务（2个以上操作）→ 任务拆分，列出子步骤\r\n │\r\n ├─ [MANDATORY] 第三步：创建进度文件（F-03，规划确认后立即执行）\r\n │ → 调用 ttask_progress.py init\r\n │\r\n └─ 第四步：进入 Execute→Review→Advance 循环\r\n```\r\n\r\n### v5.16.0 新增：参考 skill-sub 的规划逻辑（非调用链）\r\n\r\n**意图理解**（参考 skill-sub 的\"理解意图\"阶段）：\r\n- 分析用户输入，判断任务类型\r\n- 识别核心目标与约束条件\r\n- 输出：任务意图摘要\r\n\r\n**步骤排序**（参考 skill-sub 的\"规划技能顺序\"阶段）：\r\n- 推荐参与的工具/命令及其顺序\r\n- 标记步骤依赖关系\r\n- 输出：步骤顺序列表（含并行/串行标记）\r\n\r\n**执行计划生成**（参考 skill-sub 的\"生成执行计划\"阶段）：\r\n- 输出 AI 可直接执行的指令序列\r\n- 含并行/串行标记、里程碑位置\r\n- 输出：执行计划（非调用链JSON，仅为步骤描述）\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**步骤排序**（参考 skill-sub 规划逻辑）：\r\n 步骤 N: [操作描述] ── serial/parallel ── depends_on: [依赖]\r\n constraint_level: 🔴/🟡/⚪\r\n\r\n**执行计划**（参考 skill-sub 执行计划生成逻辑）：\r\n 1. [具体操作1]\r\n 2. [具体操作2]\r\n ...\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n**请确认执行（输入选项，调整请同时说明要求）**：\r\n1. 执行全部（包括问题/风险/经验记录）\r\n2. 执行但跳过问题/风险/经验记录\r\n3. 取消任务\r\n4. 调整任务\r\n\r\n请输入：\r\n```\r\n\r\n### 任务拆分模板（仅大任务，3步以上）\r\n\r\n```\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 步骤 2: [操作描述]\r\n ...\r\n\r\n**步骤排序**（参考 skill-sub）：\r\n 步骤 1 ── serial ── milestone: ✅/❌\r\n 步骤 2 🟡: [名称]（增强：来自发散方案）\r\n ⚠️ 风险：[说明]（如涉及🔴突破）\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]（必须执行，除非用户明确跳过）：\r\n → 问题记录：回顾执行过程，识别问题 → 调用 add\r\n → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r\n → 经验积累：执行完成后 → 调用 merge-to-lessons\r\n\r\n**临时进度文件**：规划确认后立即创建（F-03），每步更新（F-07），完成后删除（F-09）\r\n```\r\n\r\n---\r\n\r\n## Phase 2~4 —— 执行/审查/推进循环详细规则（增强版 v5.16.0）\r\n\r\n### [MANDATORY] EXECUTE 阶段规则\r\n\r\n> **违反 F-04：如果 AI 执行步骤前没有重述本步骤任务目的，属于违规。**\r\n> **v5.16.0 增强**：明确空转计数规则。\r\n\r\n- **[MANDATORY]** 执行前必须输出：`🔧 执行前重述目的：[本步骤目的]`\r\n- 实际运行命令、调用工具、测试代码\r\n- 只跑一个主要命令（可并行多个独立命令）\r\n- 不提前分析结果，不跳到审查阶段\r\n- **[v5.16.0 新增]** 空转判断：如果执行阶段没有实际执行任何操作（仅输出描述、未调用工具），则视为空转，空转计数+1\r\n\r\n### [MANDATORY] REVIEW 阶段规则\r\n\r\n> **违反 F-05：如果 AI 执行步骤后没有输出 REVIEW，属于违规，不得继续执行下一步。**\r\n> **v5.16.0 增强**：明确空转计数、重试计数、换思路到达的处理规则。\r\n\r\n- **[MANDATORY]** 执行后必须紧跟 REVIEW，给出明确判断：✅成功 / ❌失败 / ⚠️部分\r\n- 列出具体证据（数据、错误码、状态）\r\n- **[MANDATORY]** 对照任务目的判断是否达成\r\n- 不执行新操作\r\n- **[v5.16.0 新增]** 空转未执行 → 空转计数+1，不画√\r\n- **[v5.16.0 新增]** 重试失败 → 重试计数+1\r\n- **[v5.16.0 新增]** 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n\r\n### [MANDATORY] ADVANCE 阶段规则\r\n\r\n> **违反 F-06：如果 AI REVIEW 后没有输出 ADVANCE，属于违规，不得跳到下一步。**\r\n> **v5.16.0 增强**：明确成功/失败/空转/换思路的完整流转规则，禁止三步骤内部直接循环。\r\n\r\n- **[MANDATORY]** REVIEW 后必须紧跟 ADVANCE，明确：继续 / 换方向 / 结束 / 向上返回\r\n- **[MANDATORY]** 更新进度追踪表，标记当前步骤状态\r\n- **[MANDATORY]** 调用 `ttask_progress.py update` 持久化进度（F-07）\r\n- 不直接执行，只规划\r\n- **[v5.16.0 新增]** 成功：根据步骤确定接下来要执行什么，推进执行；**坚决不倒回已画√的步骤**\r\n- **[v5.16.0 新增]** 失败：根据重试次数明确重试 或 换思路 或 求助\r\n- **[v5.16.0 新增]** 空转：重述之前规划并告知执行必须执行 或 主动截断\r\n- **[v5.16.0 新增]** 换思路：原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n\r\n### v5.16.0 新增：空转/重试/换思路/求助 完整流转规则\r\n\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n#### 执行阶段（EXECUTE）流转规则\r\n\r\n```\r\n执行阶段（EXECUTE）\r\n ├─ 实际执行成功 → 进入 REVIEW\r\n ├─ 实际执行失败 → 重试计数+1\r\n │ ├─ 重试≤3次 → 继续重试执行\r\n │ └─ 重试>3次 → 换思路 或 求助用户\r\n ├─ 空转（未实际执行）→ 空转计数+1\r\n │ ├─ 空转≤3次 → 重述规划，明确要求必须执行\r\n │ └─ 空转>3次 → 主动截断，请求用户输入固定触发词打破空转\r\n └─ 换思路 → 原封不动推送到 REVIEW（不确认执行）\r\n```\r\n\r\n#### 审查阶段（REVIEW）流转规则\r\n\r\n```\r\n审查阶段（REVIEW）\r\n ├─ 确认上一步执行逻辑无误 → 步骤画√（✅）\r\n ├─ 空转未执行 → 空转计数+1，不画√\r\n ├─ 重试失败 → 重试计数+1\r\n ├─ 换思路到达 → 正确记录，不需要确认执行，直接推送到 ADVANCE\r\n └─ 导入分支结果 → 记录成功或失败\r\n```\r\n\r\n#### 推进阶段（ADVANCE）流转规则\r\n\r\n```\r\n推进阶段（ADVANCE）\r\n ├─ 成功 → 根据步骤确定接下来要执行什么，推进执行；坚决不倒回已画√的步骤\r\n ├─ 失败 → 根据重试次数明确重试 或 换思路 或 求助\r\n │ ├─ 重试次数<3 → 推进重试执行\r\n │ ├─ 重试次数≥3 → 换思路 或 求助用户\r\n │ └─ 求助 → 明确发出交互请求，主动截断并等待用户输入\r\n ├─ 换思路 → 原封不动推送到 REVIEW（经 REVIEW→ADVANCE→EXECUTE 循环处理）\r\n │ → 哪怕是换思路，也要由 ADVANCE 推到 EXECUTE 再推到 REVIEW 再推到 ADVANCE 来进行换思路思考\r\n │ → 没有任何三步骤内部直接循环的情况，每一步都是最小单元，不能自循环闭环\r\n └─ 空转 → 重述之前规划并告知执行必须执行 或 主动截断\r\n ├─ 空转次数<3 → 重述之前规划并告知执行必须执行，返回 EXECUTE\r\n └─ 空转次数≥3 → 主动截断，请求用户输入固定触发词打破空转，停止并发出交互请求\r\n```\r\n\r\n#### 固定触发词打破空转规则\r\n\r\n> **v5.16.0 新增**：当空转次数≥3次时，AI 必须主动截断当前流程，请求用户输入固定触发词来重新激发执行。\r\n\r\n**触发词**：`继续执行`（用户可自定义，见配置）\r\n\r\n**截断后行为**：\r\n1. AI 输出：`⚠️ 空转次数已达到3次，主动截断。请输入触发词\"继续执行\"以重新激发执行。`\r\n2. AI 停止当前执行循环，等待用户输入\r\n3. 用户输入触发词后，AI 重新进入 EXECUTE 阶段，重置空转计数（可选），继续执行\r\n\r\n#### 求助规则\r\n\r\n> **v5.16.0 新增**：当超出重试或空转次数时，AI 必须明确发出交互请求，主动截断并等待用户输入。\r\n\r\n**触发条件**：\r\n- 同一步骤失败，重试次数≥3次\r\n- 同一步骤空转次数≥3次\r\n- 换思路后仍无法继续执行\r\n\r\n**求助输出格式**：\r\n```\r\n⚠️ 求助请求\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n**问题描述**：[描述当前遇到的问题，为什么无法继续]\r\n\r\n**已尝试方案**：\r\n 1. [方案1]（失败原因）\r\n 2. [方案2]（失败原因）\r\n 3. [方案3]（失败原因）\r\n\r\n**需要帮助的内容**：\r\n - [具体问题1]\r\n - [具体问题2]\r\n\r\n**建议下一步**：\r\n - [建议1]\r\n - [建议2]\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n请提供指导或输入触发词\"继续执行\"以继续。\r\n```\r\n\r\n### 执行输出标准格式\r\n\r\n```\r\n### 🔧 [EXECUTE] - 步骤 N\r\n🔧 执行前重述目的：[本步骤任务目的]\r\n（执行操作...）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 🔍 [REVIEW] - 步骤 N\r\n[✅成功/❌失败/⚠️部分] -- [具体证据]\r\n→ [v5.16.0 新增] 重试计数：N（若失败，则+1）\r\n→ [v5.16.0 新增] 空转计数：N（若空转，则+1）\r\n\r\n### 📍 [ADVANCE] - 步骤 N\r\n推进：[继续步骤 N+1 / 重试 / 换方案 / 任务完成 / 求助]\r\n→ [v5.16.0 新增] 若换思路：原封不动推送到 REVIEW（不确认执行）\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ N │ ... │ ... │ ... │ ... │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：N/Total（X%）▸ 下一：步骤 N+1\r\n```\r\n\r\n### 状态标记规则\r\n\r\n| 标记 | 含义 | 说明 |\r\n|------|------|------|\r\n| ⏳ | 待执行 | 初始状态 |\r\n| 🔄 | 执行中 | 正在执行 |\r\n| ✅ | 成功 | 审查通过 |\r\n| ❌ | 失败 | 需要重试或换方案 |\r\n| ⏭️ | 跳过 | 经评估无需执行 |\r\n| 🔁 | 重试中 | 正在重试（重试计数 由 `permission_checker.py` 扫描生成（2026-05-24），扫描 8 个文件、3219 行。\r\n\r\n## 扫描结果摘要\r\n\r\n| 项目 | 值 |\r\n|------|-----|\r\n| 风险等级 | **MEDIUM** |\r\n| 权限权重 | **50.00%** |\r\n| 扫描文件数 | 8 |\r\n| 扫描行数 | 3219 |\r\n| 问题总数 | 28 |\r\n\r\n## 权限统计\r\n\r\n| 权限类型 | 次数 | 权重 |\r\n|---------|------|------|\r\n| `sensitive_access` | 0 | 40% |\r\n| `critical_write` | 0 | 30% |\r\n| `network_access` | 1 | 20% |\r\n| `file_delete` | 6 | 10% |\r\n| `subprocess_call` | 21 | — |\r\n\r\n## 高权限操作清单\r\n\r\n### subprocess_call（21 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/cron_helper.py` | 17, 43 | `subprocess` | `immediate` |\r\n| `scripts/exec_wrapper.py` | 32, 167, 180, 187, 195 | `subprocess` | `immediate` |\r\n| `scripts/install.py` | 85, 88, 126, 214 | `subprocess` / `exec(` | `immediate` |\r\n| `scripts/lessons_register.py` | 18, 60, 83 | `subprocess` | `immediate` |\r\n| `scripts/problem_daemon.py` | 27, 160, 413, 416, 417, 439 | `subprocess` / `Popen` | `immediate` |\r\n\r\n### file_delete（6 处，HIGH）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/install.py` | 76, 189 | `shutil.rmtree` | `immediate` |\r\n| `scripts/ttask_progress.py` | 439, 443, 496, 501 | `os.remove` | `immediate` |\r\n\r\n### network_access（1 处，MEDIUM）\r\n\r\n| 文件 | 行号 | 匹配模式 | 授权方式 |\r\n|------|-------|----------|----------|\r\n| `scripts/settings.py` | 25 | `urllib` | `unified` |\r\n\r\n## 授权方式说明\r\n\r\n| 方式 | 适用场景 | 说明 |\r\n|------|----------|------|\r\n| `unified` | 中风险操作（network_access） | 批量统一授权，首次确认后可复用 |\r\n| `immediate` | 高风险操作（subprocess_call、file_delete） | 每次执行前需用户确认 |\r\n| `silent` | 低风险操作 | 无需授权，静默执行 |\r\n\r\n## 风险结论\r\n\r\n- **风险等级：MEDIUM**（权重 50%）\r\n- **建议**：高权限操作（subprocess、文件删除）已标注 `immediate` 授权方式，符合规范；网络访问（`settings.py`）使用 `unified` 授权，符合规范。\r\n- **R-15 检查**：所有高权限操作前均应有授权检查逻辑。\n\nFile v5.17.1:references/reference.md\n\n# reference.md — CLI 命令速查、进度文件、问题记录、数据目录、安装\r\n\r\n> 本文件包含 triphasic-execution 的完整命令参考和配置说明，供需要时加载。\r\n\r\n---\r\n\r\n## 临时进度文件机制\r\n\r\n> **[MANDATORY]** 违反 F-03/F-07/F-09 属于严重违规。\r\n\r\n### 核心原理\r\n\r\n```\r\n任务规划确认\r\n └─→ [MANDATORY] 创建临时进度文件（init）\r\n │\r\n ├─ 步骤1 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n ├─ 步骤2 ADVANCE 后 → [MANDATORY] 更新文件（update）\r\n │ ...\r\n └─ 任务完成 → [MANDATORY] 删除进度文件（complete）\r\n 中断\n\nArchive v5.17.0: 18 files, 57121 bytes\n\nFiles: _meta.json (139b), references/antipatterns.md (4120b), references/changelog.md (5030b), references/examples.md (5862b), references/faq.md (5594b), references/mandatory.md (18649b), references/permission_report.json (11592b), references/permissions.md (2305b), references/reference.md (7745b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/task_progress.py (33831b), skill-card.md (2569b), SKILL.md (10287b)\n\nArchive v5.15.0: 21 files, 60482 bytes\n\nFiles: _meta.json (139b), assets/default_config.json (782b), assets/settings.html (15232b), references/antipatterns.md (2724b), references/changelog.md (2041b), references/examples.md (5862b), references/faq.md (4136b), references/mandatory.md (9011b), references/permission_report.json (11588b), references/permissions.md (2242b), references/reference.md (7543b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20825b), scripts/task_progress.py (25524b), skill-card.md (2489b), SKILL.md (8687b)\n\nArchive v5.14.0: 18 files, 54803 bytes\n\nFiles: _meta.json (139b), assets/default_config.json (782b), assets/settings.html (15232b), references/changelog.md (1292b), references/examples.md (5720b), references/mandatory.md (9009b), references/permission_report.json (11588b), references/permission.md (2242b), references/reference.md (7537b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20825b), scripts/task_progress.py (25524b), SKILL.md (7746b)\n\nArchive v5.13.0: 16 files, 52025 bytes\n\nFiles: _meta.json (139b), assets/default_config.json (782b), assets/settings.html (15232b), references/changelog.md (432b), references/examples.md (5720b), references/mandatory.md (9009b), references/reference.md (7537b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20825b), scripts/task_progress.py (25524b), SKILL.md (7746b)\n\nArchive v5.11.0: 16 files, 49722 bytes\n\nFiles: _meta.json (139b), assets/default_config.json (782b), assets/settings.html (15232b), references/changelog.md (432b), references/examples.md (5720b), references/mandatory.md (9009b), references/reference.md (5805b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20825b), scripts/task_progress.py (19898b), SKILL.md (7123b)\n\nArchive v5.10.0: 16 files, 49271 bytes\n\nFiles: _meta.json (139b), assets/default_config.json (788b), assets/settings.html (15154b), default_config.json (707b), references/examples.md (5720b), references/mandatory.md (9009b), references/reference.md (5779b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20180b), scripts/task_progress.py (19641b), SKILL.md (6680b)\n\nArchive v5.9.0: 13 files, 47037 bytes\n\nFiles: _meta.json (138b), assets/default_config.json (788b), assets/settings.html (15154b), default_config.json (707b), scripts/cron_helper.py (4029b), scripts/exec_wrapper.py (8497b), scripts/install.py (8704b), scripts/lessons_register.py (5939b), scripts/problem_daemon.py (20221b), scripts/problem_logger.py (19698b), scripts/settings.py (20180b), scripts/task_progress.py (19641b), SKILL.md (28154b)","readmeExcerpt":"Skill: triphasic-execution Owner: ldxs001 Summary: Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。 Tags: latest:5.19.1 Version history: v5.19.1 | 2026-06-25T10:26:07.873Z | auto **Enforces stricter protocol for step-execution, adds config UI, and updates file/data layout.** - Added HTML configuration interface (assets/settings.html) and Python config UI script (scripts/settings","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"File v5.19.1:references/faq.md\n\n# Triphasic Execution - 常见问题（FAQ）\r\n\r\n本文档收录使用本技能时的常见问题和解答。\r\n\r\n---\r\n\r\n## Q&A 列表\r\n\r\n### Q1：什么时候应该使用 triphasic-execution？\r\n\r\n**A：** 当任务满足以下任一条件时：\r\n- 多步骤任务（≥3 步）\r\n- 容易出现死循环或无限重试\r\n- 需要中断恢复能力\r\n- 需要结构化的问题/风险/经验记录\r\n\r\n**不适合的场景：**\r\n- 简单问答（单步即可完成）\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n- 用户明确要求不使用本技能\r\n\r\n---\r\n\r\n### Q2：语义拆分是什么？为什么要强制？\r\n\r\n**A：** 语义拆分是将用户任务拆解为结构化字段：\r\n- **主语**：谁发起的任务\r\n- **目的**：为什么要做这个任务\r\n- **诉求**：具体要做什么\r\n- **动机**：深层需求是什么\r\n\r\n**强制原因：** 防止 AI 误解任务意图，导致执行方向错误。\r\n\r\n---\r\n\r\n### Q3：F-02 要求规划必须用户确认，能不能跳过？\r\n\r\n**A：** 不能。F-02 是强制约束（用 ❌ AI 自觉 标记），必须输出规划并等待用户确认后才能执行。\r\n\r\n**例外：** 如果用户明确说\"直接执行\"、\"不需要确认\"，可以跳过，但需要在规划中说明。\r\n\r\n---\r\n\r\n### Q4：task_progress.py 有什么用？不用行不行？\r\n\r\n**A：** `task_progress.py` 用于持久化进度，支持中断恢复。F-03 强制要求调用 `init`，F-07 强制要求每步调用 `update`，F-09 强制要求任务完成时调用 `complete`。\r\n\r\n**不用的后果：**\r\n- 任务中断后无法恢复\r\n- 无法追踪步骤完成率\r\n- `complete` 校验会失败（v5.12+）\r\n\r\n---\r\n\r\n### Q5：同一步骤失败 3 次后必须换方案，能不能第 4 次重试？\r\n\r\n**A：** 不能。F-08 是强制约束，第 4 次重试违反规范。\r\n\r\n**正确做法：**\r\n- 第 1~3 次：尝试同一方案\r\n- 第 3 次失败后：换方案（完全不同思路）\r\n- 新方案再失败：继续换，直到任务完成或所有方案耗尽\r\n\r\n---\r\n\r\n### Q6：`complete` 校验失败怎么办？\r\n\r\n**A：** `complete` 校验检查以下内容：\r\n1. 步骤完成率（所有步骤必须标记为 success）\r\n2. 记录文件（PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md）\r\n3. summary.json（任务总结）\r\n\r\n**修复方法：**\r\n- 完成所有未完成的步骤\r\n- 运行 `problem_logger.py add` 记录问题/风险\r\n- 运行 `task_progress.py complete --force` 跳过步骤检查（不推荐）\r\n- 运行 `task_progress.py complete --no-enforce` 关闭记录校验（不推荐）\r\n\r\n---\r\n\r\n### Q7：按需调用模式和全局自动模式有什么区别？\r\n\r\n**A：**\r\n- **按需调用（默认）**：用户说出关键词（\"三步执行\"、\"triphasic\"等）才触发\r\n- **全局自动模式**：所有任务自动套用框架，无需关键词\r\n\r\n**切换方法：**\r\n编辑 `data/default_config.json` → `\"mode\": \"auto\"`\r\n\r\n---\r\n\r\n### Q8：settings.py 是干什么的？\r\n\r\n**A：** `settings.py` 是一个 HTML 可视化配置界面，用于配置技能参数（如模式、重试次数、记录文件路径等）。\r\n\r\n**运行方法：**"},{"language":"text","snippet":"File v5.19.1:references/mandatory.md\n\n# mandatory.md — 强制约束详细规则\r\n\r\n> 本文件包含 triphasic-execution 的完整强制约束内容，供需要深入了解规则细节时加载。\r\n\r\n---\r\n\r\n## Phase 0 —— 语义拆分完整规则（增强版 v5.16.0）\r\n\r\n> **违反 F-01：如果 AI 没有输出语义拆分就开始规划或执行，属于严重违规。必须回滚并先输出拆分结果。**\r\n> **v5.16.0 增强**：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力。\r\n\r\n### 拆分规则（增强版）\r\n\r\n**块（Block）识别**：按主语划分，每个主语构成一个块。\r\n\r\n| 主语类型 | 识别方式 |\r\n|---------|---------|\r\n| 用户（\"我\"） | 说话者本人 |\r\n| AI 助手（\"你\"） | 执行者、帮助者 |\r\n| 第三方（\"他/她/它\"） | 提及的其他角色 |\r\n\r\n**每个块提取三类信息：**\r\n\r\n| 元素 | 定义 | 增强标注 |\r\n|-----|------|---------|\r\n| **目的** | 最终要达成的目标 | 标注🔴🟡⚪约束强度 |\r\n| **诉求** | 需要执行的具体操作或交付物 | 硬约束🔴/软约束🟡/无约束⚪ |\r\n| **动机** | 为什么会产生这个需求 | 背景/原因/情绪 |\r\n\r\n### v5.16.0 新增：5W2H 维度提取（参考 semantic-split）\r\n\r\n**步骤 0.5**：任务类型识别与 5W2H 初始化（内部执行，不输出）\r\n\r\n1. **任务类型识别**：制作PPT / 填写周报 / 安排行程 / 写邮件 / 策划活动 / 其他\r\n2. **5W2H 维度初始化**：按任务类型从默认映射表填入默认值\r\n3. **约束强度预标注**：🔴硬约束 / 🟡软约束 / ⚪无约束\r\n\r\n**步骤 0.7**：注意力锚定（内部执行，不输出）\r\n\r\n1. `[CRITICAL]` — 硬约束，后续不可违反\r\n2. `[CORE]` — 核心目标（动词+宾语）\r\n3. `[ENTITY]` — 数字、时间、人名\r\n4. `[EXAMPLE]` — 举例内容，降权不作为约束\r\n5. `[RESISTANCE]` — 「但是/担心/难」后内容\r\n6. 核心句重构：「[主语] 要 [CORE] 于 [时间/场景]」（≤20字）\r\n\r\n### v5.16.0 新增：自我反查（内部执行，不输出）\r\n\r\n| 反查 | 检查内容 | 修正 |\r\n|------|---------|------|\r\n| 1 | 硬约束遗漏：`[CRITICAL]` 是否全在结果中？ | 补充 |\r\n| 2 | 约束误判：🟡 词被标为 🔴？ | 修正 |\r\n| 2b | 隐式升级：🟡 约束属组织规范/法律/安全？→ 🟡🔴 或 🔴 | 升级 |\r\n| 3 | 举例干扰：`[EXAMPLE]` 被当核心诉求？ | 降级 |\r\n| 4 | 5W2H 缺失：有明显可推断维度？ | 补充 `[推断]` |\r\n\r\n### 输出格式（[MANDATORY] 必须按此格式输出）"},{"language":"text","snippet":"File v5.19.1:references/permission_report.json\n\n{\r\n \"skill_dir\": \"C:\\\\Users\\\\sm001\\\\.workbuddy\\\\skills\\\\triphasic-execution\",\r\n \"risk_level\": \"medium\",\r\n \"permission_weight\": 0.5,\r\n \"stats\": {\r\n \"files_scanned\": 8,\r\n \"lines_scanned\": 3219,\r\n \"sensitive_access\": 0,\r\n \"critical_write\": 0,\r\n \"network_access\": 1,\r\n \"file_delete\": 6,\r\n \"subprocess_call\": 21\r\n },\r\n \"issues\": [\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\cron_helper.py\",\r\n \"line\": 17,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\cron_helper.py\",\r\n \"line\": 43,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 32,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 167,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 180,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system"},{"language":"text","snippet":"File v5.17.3:references/faq.md\n\n# Triphasic Execution - 常见问题（FAQ）\r\n\r\n本文档收录使用本技能时的常见问题和解答。\r\n\r\n---\r\n\r\n## Q&A 列表\r\n\r\n### Q1：什么时候应该使用 triphasic-execution？\r\n\r\n**A：** 当任务满足以下任一条件时：\r\n- 多步骤任务（≥3 步）\r\n- 容易出现死循环或无限重试\r\n- 需要中断恢复能力\r\n- 需要结构化的问题/风险/经验记录\r\n\r\n**不适合的场景：**\r\n- 简单问答（单步即可完成）\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n- 用户明确要求不使用本技能\r\n\r\n---\r\n\r\n### Q2：语义拆分是什么？为什么要强制？\r\n\r\n**A：** 语义拆分是将用户任务拆解为结构化字段：\r\n- **主语**：谁发起的任务\r\n- **目的**：为什么要做这个任务\r\n- **诉求**：具体要做什么\r\n- **动机**：深层需求是什么\r\n\r\n**强制原因：** 防止 AI 误解任务意图，导致执行方向错误。\r\n\r\n---\r\n\r\n### Q3：F-02 要求规划必须用户确认，能不能跳过？\r\n\r\n**A：** 不能。F-02 是强制约束（用 ❌ AI 自觉 标记），必须输出规划并等待用户确认后才能执行。\r\n\r\n**例外：** 如果用户明确说\"直接执行\"、\"不需要确认\"，可以跳过，但需要在规划中说明。\r\n\r\n---\r\n\r\n### Q4：task_progress.py 有什么用？不用行不行？\r\n\r\n**A：** `task_progress.py` 用于持久化进度，支持中断恢复。F-03 强制要求调用 `init`，F-07 强制要求每步调用 `update`，F-09 强制要求任务完成时调用 `complete`。\r\n\r\n**不用的后果：**\r\n- 任务中断后无法恢复\r\n- 无法追踪步骤完成率\r\n- `complete` 校验会失败（v5.12+）\r\n\r\n---\r\n\r\n### Q5：同一步骤失败 3 次后必须换方案，能不能第 4 次重试？\r\n\r\n**A：** 不能。F-08 是强制约束，第 4 次重试违反规范。\r\n\r\n**正确做法：**\r\n- 第 1~3 次：尝试同一方案\r\n- 第 3 次失败后：换方案（完全不同思路）\r\n- 新方案再失败：继续换，直到任务完成或所有方案耗尽\r\n\r\n---\r\n\r\n### Q6：`complete` 校验失败怎么办？\r\n\r\n**A：** `complete` 校验检查以下内容：\r\n1. 步骤完成率（所有步骤必须标记为 success）\r\n2. 记录文件（PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md）\r\n3. summary.json（任务总结）\r\n\r\n**修复方法：**\r\n- 完成所有未完成的步骤\r\n- 运行 `problem_logger.py add` 记录问题/风险\r\n- 运行 `task_progress.py complete --force` 跳过步骤检查（不推荐）\r\n- 运行 `task_progress.py complete --no-enforce` 关闭记录校验（不推荐）\r\n\r\n---\r\n\r\n### Q7：按需调用模式和全局自动模式有什么区别？\r\n\r\n**A：**\r\n- **按需调用（默认）**：用户说出关键词（\"三步执行\"、\"triphasic\"等）才触发\r\n- **全局自动模式**：所有任务自动套用框架，无需关键词\r\n\r\n**切换方法：**\r\n编辑 `data/default_config.json` → `\"mode\": \"auto\"`\r\n\r\n---\r\n\r\n### Q8：settings.py 是干什么的？\r\n\r\n**A：** `settings.py` 是一个 HTML 可视化配置界面，用于配置技能参数（如模式、重试次数、记录文件路径等）。\r\n\r\n**运行方法：**"},{"language":"text","snippet":"File v5.17.3:references/mandatory.md\n\n# mandatory.md — 强制约束详细规则\r\n\r\n> 本文件包含 triphasic-execution 的完整强制约束内容，供需要深入了解规则细节时加载。\r\n\r\n---\r\n\r\n## Phase 0 —— 语义拆分完整规则（增强版 v5.16.0）\r\n\r\n> **违反 F-01：如果 AI 没有输出语义拆分就开始规划或执行，属于严重违规。必须回滚并先输出拆分结果。**\r\n> **v5.16.0 增强**：参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力。\r\n\r\n### 拆分规则（增强版）\r\n\r\n**块（Block）识别**：按主语划分，每个主语构成一个块。\r\n\r\n| 主语类型 | 识别方式 |\r\n|---------|---------|\r\n| 用户（\"我\"） | 说话者本人 |\r\n| AI 助手（\"你\"） | 执行者、帮助者 |\r\n| 第三方（\"他/她/它\"） | 提及的其他角色 |\r\n\r\n**每个块提取三类信息：**\r\n\r\n| 元素 | 定义 | 增强标注 |\r\n|-----|------|---------|\r\n| **目的** | 最终要达成的目标 | 标注🔴🟡⚪约束强度 |\r\n| **诉求** | 需要执行的具体操作或交付物 | 硬约束🔴/软约束🟡/无约束⚪ |\r\n| **动机** | 为什么会产生这个需求 | 背景/原因/情绪 |\r\n\r\n### v5.16.0 新增：5W2H 维度提取（参考 semantic-split）\r\n\r\n**步骤 0.5**：任务类型识别与 5W2H 初始化（内部执行，不输出）\r\n\r\n1. **任务类型识别**：制作PPT / 填写周报 / 安排行程 / 写邮件 / 策划活动 / 其他\r\n2. **5W2H 维度初始化**：按任务类型从默认映射表填入默认值\r\n3. **约束强度预标注**：🔴硬约束 / 🟡软约束 / ⚪无约束\r\n\r\n**步骤 0.7**：注意力锚定（内部执行，不输出）\r\n\r\n1. `[CRITICAL]` — 硬约束，后续不可违反\r\n2. `[CORE]` — 核心目标（动词+宾语）\r\n3. `[ENTITY]` — 数字、时间、人名\r\n4. `[EXAMPLE]` — 举例内容，降权不作为约束\r\n5. `[RESISTANCE]` — 「但是/担心/难」后内容\r\n6. 核心句重构：「[主语] 要 [CORE] 于 [时间/场景]」（≤20字）\r\n\r\n### v5.16.0 新增：自我反查（内部执行，不输出）\r\n\r\n| 反查 | 检查内容 | 修正 |\r\n|------|---------|------|\r\n| 1 | 硬约束遗漏：`[CRITICAL]` 是否全在结果中？ | 补充 |\r\n| 2 | 约束误判：🟡 词被标为 🔴？ | 修正 |\r\n| 2b | 隐式升级：🟡 约束属组织规范/法律/安全？→ 🟡🔴 或 🔴 | 升级 |\r\n| 3 | 举例干扰：`[EXAMPLE]` 被当核心诉求？ | 降级 |\r\n| 4 | 5W2H 缺失：有明显可推断维度？ | 补充 `[推断]` |\r\n\r\n### 输出格式（[MANDATORY] 必须按此格式输出）"},{"language":"text","snippet":"File v5.17.3:references/permission_report.json\n\n{\r\n \"skill_dir\": \"C:\\\\Users\\\\sm001\\\\.workbuddy\\\\skills\\\\triphasic-execution\",\r\n \"risk_level\": \"medium\",\r\n \"permission_weight\": 0.5,\r\n \"stats\": {\r\n \"files_scanned\": 8,\r\n \"lines_scanned\": 3219,\r\n \"sensitive_access\": 0,\r\n \"critical_write\": 0,\r\n \"network_access\": 1,\r\n \"file_delete\": 6,\r\n \"subprocess_call\": 21\r\n },\r\n \"issues\": [\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\cron_helper.py\",\r\n \"line\": 17,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\cron_helper.py\",\r\n \"line\": 43,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 32,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 167,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system/subprocess等）\",\r\n \"severity\": \"HIGH\",\r\n \"authorization_method\": \"immediate\",\r\n \"reason\": \"高风险操作，每次执行前需用户确认\"\r\n },\r\n {\r\n \"type\": \"subprocess_call\",\r\n \"file\": \"scripts\\\\exec_wrapper.py\",\r\n \"line\": 180,\r\n \"pattern\": \"subprocess\",\r\n \"match\": \"subprocess\",\r\n \"description\": \"检测到 subprocess 调用（os.system"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: triphasic-execution\r\nversion: 5.19.1\r\nauthor: wUwproject\r\nlicense: MIT\r\ndescription: Execute→Review→Advance 三步循环执行框架。增强步骤规划能力、增强语义理解；明确空转/重试/换思路/求助完整流转规则；最多重试3次、最多空转3次强制约束。\r\ntags: ['framework', 'execution', 'debugging', 'problem-tracking', 'risk-tracking', 'lessons-learned', 'cross-platform', 'configuration', 'config-ui']\r\ncategory: workflow\r\ntrigger: ['三步循环', 'Execute', 'Review', 'Advance', '步骤', 'pre_exec', 'verify_exec', 'retry', 'idle']\r\ntrigger_negative: true\r\nsensitive_access: false\r\ncritical_write: false\r\npermission_weight: LOW\r\ndata_dir: ../.standardization/triphasic-execution/data/\r\nexternal_data_dir: true\r\nmeta_field_sync: true\r\nh1_position: true\r\n---\r\n# Triphasic Execution Framework\r\n执行 → 审查 → 推进。每次交互只做一件事，三者缺一不可。\r\n\r\n> → 详见 `references/antipatterns.md`\r\n> → 详见 `references/faq.md`\r\n\r\n---\r\n\r\n## 触发条件\r\n\r\n**正向触发（满足以下任意一条）：**\r\n\r\n- 说出\"三步执行\"、\"执行审查推进\"、\"triphasic\"\r\n- 说出\"问题记录\"、\"经验教训\"、\"problem logger\"\r\n- 说出\"打开 triphasic 配置\"、\"triphasic config\"\r\n- 需要结构化执行框架防止死循环或跳步\r\n- 复杂多步骤任务，需要强制进度追踪和中断恢复\r\n\r\n**否定条件（满足以下任意一条，不触发）：**\r\n\r\n- 简单问答、闲聊、问候（不需要结构化执行）\r\n- 单步任务（如\"查看文件\"、\"运行命令\"等一步完成的操作）\r\n- 用户明确说\"不要使用 triphasic\"或\"关闭 triphasic\"\r\n- 纯信息查询（不需要执行-审查-推进循环）\r\n\r\n---\r\n\r\n## 核心能力\r\n\r\n> 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。\r\n\r\n| # | 能力 | 说明 |\r\n|---|------|------|\r\n| 1 | **语义理解增强（F-01+）** | 参考 semantic-split 的 5W2H 维度提取与约束强度标注（🔴🟡⚪），增强第一步理解能力；详见 `references/mandatory.md` Phase 0 |\r\n| 2 | **步骤规划增强（F-02+）** | 参考 skill-sub 的规划逻辑（意图理解→步骤排序→执行计划生成），健壮步骤规划能力（非调用链，仅参考逻辑）；详见 `references/mandatory.md` Phase 1 |\r\n| 3 | **三步循环执行** | Execute→Review→Advance，每步必须完整，不可跳过 |\r\n| 4 | **进度文件持久化（F-03/F-07/F-09）** | init→update→complete，中断后可 resume 恢复；**complete 强制校验（v5.12）** |\r\n| 5 | **问题/风险/经验记录** | 任务完成后强制记录（复杂任务 Python 侧校验），积累 PROBLEMS.md / RISKS.md / LESSONS_REGISTER.md |\r\n| 6 | **最多 3 次重试（F-08）** | 同一步骤失败 3 次必须换方案，禁止第 4 次重试 |\r\n| 7 | **最多 3 次空转（F-11）** | 同一步骤空转（未实际执行）3 次必须截断并请求触发词输入，禁止第 4 次空转 |\r\n| 8 | **双模式支持** | 按需调用模式（默认）/ 全局自动模式 |\r\n| 9 | **HTML 配置界面** | `settings.py` 可视化配置技能参数 |\r\n\r\n---\r\n\r\n## 空转/重试/换思路/求助 流转规则\r\n\r\n> 详细规则见 `references/mandatory.md` Phase 2~4。\r\n> **核心原则：无任何三步骤内部直接循环，每一步都是最小单元。**\r\n\r\n---\r\n\r\n## 快速开始\r\n\r\n```bash\r\n# 按需调用（默认）— 任务开头说出关键词即可\r\n\"使用 triphasic-execution 执行以下任务：...\"\r\n\r\n# 全局自动模式 — 所有任务自动套用框架\r\n编辑 data/default_config.json → \"mode\": \"auto\"\r\n\r\n# 可视化配置\r\npython {SKILL_DIR}/scripts/settings.py\r\n```\r\n\r\n---\r\n\r\n## ⚡ [LOADING PROTOCOL]\r\n\r\nskill 加载后，AI 输出以下状态标识：\r\n\r\n```\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n```\r\n\r\n| 观察结果 | 结论 |\r\n|---------|------|\r\n| 状态输出在任务相关内容之前出现 | ✅ 执行顺序正确 |\r\n| 状态输出在任务执行后才出现 | ❌ 执行顺序错误 |\r\n| 无状态输出 | ❌ skill 未加载 |\r\n\r\n---\r\n\r\n## 🚨 [MANDATORY] 强制约束总表\r\n\r\n> **本节是整个技能的执行宪法。违反任意一条 = 违规，必须立即停止并补救。**\r\n\r\n| 序号 | 约束内容 | 触发时机 | Python 强制 |\r\n|------|---------|---------|------------|\r\n| **F-01** | 收到任务后首先执行语义拆分，禁止直接进入规划 | 收到任务第一个响应 | ❌ AI 自觉 |\r\n| **F-02** | 语义拆分完成后必须输出【任务规划】，禁止直接执行 | 语义拆分输出后 | ❌ AI 自觉（需用户确认规划）|\r\n| **F-03** | 任务规划输出后立即调用 `task_progress.py init` | 规划确认后 | ✅ 文件不存在则后续 update/complete 报错 |\r\n| **F-04**"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn75zfd51df61ajdyqtgvrs1hx84s4q6\",\n \"slug\": \"triphasic-execution\",\n \"version\": \"5.19.1\",\n \"publishedAt\": 1782383167873\n}"},{"path":"references/antipatterns.md","content":"# Triphasic Execution - 反模式（Antipatterns）\r\n\r\n本文档收录使用本技能时的常见错误和注意事项。\r\n\r\n---\r\n\r\n## 反模式列表\r\n\r\n### ❌ AP-01：跳过语义拆分直接规划\r\n\r\n**错误做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[直接输出任务规划]\r\n```\r\n\r\n**正确做法：**\r\n```\r\n用户：\"帮我修复这个 bug\"\r\nAI：[首先输出语义拆分]\r\n - 主语：用户\r\n - 目的：修复 bug\r\n - 诉求：定位并修复代码错误\r\n - 动机：恢复功能正常\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-02：跳过审查直接推进\r\n\r\n**错误做法：**\r\n```\r\nEXECUTE → [无 REVIEW] → ADVANCE\r\n```\r\n\r\n**正确做法：**\r\n```\r\nEXECUTE → REVIEW（✅/❌/⚠️ + 证据）→ ADVANCE\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-03：同一步骤无限重试\r\n\r\n**错误做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 重试\r\n第 4 次失败 → 重试（❌ 违反 F-08）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次失败 → 重试\r\n第 2 次失败 → 重试\r\n第 3 次失败 → 换方案（✅ 遵守 F-08）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-04：进度文件未创建就执行\r\n\r\n**错误做法：**\r\n```\r\n任务规划 → [无 task_progress.py init] → 直接执行\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务规划 → task_progress.py init → 执行（✅ 遵守 F-03）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-05：任务完成未调用 complete\r\n\r\n**错误做法：**\r\n```\r\n任务执行完 → [无 task_progress.py complete] → 结束\r\n```\r\n\r\n**正确做法：**\r\n```\r\n任务执行完 → task_progress.py complete → 输出总结（✅ 遵守 F-09）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-06：中英文混排缺少空格\r\n\r\n**错误做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n**正确做法：**\r\n```\r\n\"运行 settings.py 配置参数\"\r\n\"使用 problem_logger 记录问题\"\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-07：空转超过 3 次未截断（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n第 1 次空转 → 继续\r\n第 2 次空转 → 继续\r\n第 3 次空转 → 继续\r\n第 4 次空转 → 继续（❌ 违反 F-11）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n第 1 次空转 → 重述规划，明确要求必须执行\r\n第 2 次空转 → 重述规划，明确要求必须执行\r\n第 3 次空转 → 主动截断，请求用户输入触发词（✅ 遵守 F-11）\r\n```\r\n\r\n---\r\n\r\n### ❌ AP-08：换思路时三步骤内部直接循环（v5.16.0 新增）\r\n\r\n**错误做法：**\r\n```\r\n换思路 → 直接执行新方案（❌ 跳过 REVIEW→ADVANCE）\r\n换思路 → 直接推进（❌ 跳过 EXECUTE→REVIEW）\r\n```\r\n\r\n**正确做法：**\r\n```\r\n换思路 → 原封不动推送到 REVIEW\r\n ↓\r\n REVIEW（记录换思路，不确认执行）\r\n ↓\r\n ADVANCE（推进换思路执行）\r\n ↓\r\n EXECUTE（执行新方案）\r\n ↓\r\n REVIEW → ADVANCE（完整三步循环）（✅ 遵守 F-12）\r\n```\r\n\r\n---\r\n\r\n## 注意事项\r\n\r\n1. **语义拆分是强制的** — 收到任务第一个动作必须是语义拆分，不能跳过\r\n2. **规划必须用户确认** — F-02 要求规划输出后需用户确认才能执行\r\n3. **三步循环不可跳过** — Execute→Review→Advance 缺一不可\r\n4. **进度文件必须创建** — F-03 强制要求 init，否则后续 update/complete 会报错\r\n5. **最多 3 次重试** — F-08 强制要求，第 4 次必须换方案\r\n6. **最多 3 次空转** — F-11 强制要求，第 4 次必须截断并请求触发词输入\r\n7. **换思路必须走完整三步** — F-12 强制要求，禁止三步骤内部直接循环\r\n\r\n---\r\n\r\n## 常见问题排查\r\n\r\n| 问题 | 原因 | 解决方案 |\r\n|------|------|----------|\r\n| `task_progress.py update` 报错 | 未执行 `init` | 先执行 `task_progress.py init` |\r\n| `complete` 校验失败 | 步骤完成率不足 | 检查哪些步骤未标记为 success |\r\n| 重试次数超限 | 同一方案失败 3 次 | 换方案，禁止第 4 次重试 |\r\n| 进度文件丢失 | 误删除或路径错误 | 重新执行 `init`，或手动创建进度文件 |"},{"path":"references/changelog.md","content":"## 5.19.1 (2026-06-09)\r\n\r\n### 修复\r\n- **强制约束总表过时标记**：F-05/F-06/F-08/F-11 的\"Python 强制\"列从\"❌ AI 自觉\"修正为\"✅ 脚本强制/钩子拦截\"\r\n\r\n---\r\n\r\n## 5.19.0 (2026-06-09)\r\n\r\n### 新增\r\n- **P0/P1/P2 钩子系统**：pre_exec_search（执行前 REVIEW 校验）、require_complete_validation（complete 4 项校验）、auto_idle_cutoff（空转≥3 自动 abort）、block_skip_review（跳过 REVIEW 拦截）\r\n- **UI 配置支持完整钩子**：settings.html 新增强制纪律区域，6 个 toggle 开关\r\n- **文本/HTML 配置同步**：save_config_from_json 与 _do_save_config 采用相同 merge 逻辑\r\n\r\n### 改进\r\n- **数据目录规范化**：按 skill-standardization R-12 规范重组标准化目录结构\r\n - data/active/、data/completed/、output/、logs/、temp/、backup/、cache/、state/\r\n- **6 个脚本路径统一**：全部使用 _find_standardization_dir() 计算路径\r\n- **settings.html 移入 assets/**：功能文件与数据目录分离\r\n- **R-12 数据目录锚点补全**：cron_helper.py、exec_wrapper.py、lessons_register.py、problem_daemon.py 补充 DEFAULT_DATA_DIR_RAW\r\n- **R-17 行数合规**：SKILL.md 精简至 230 行\r\n\r\n### 修复\r\n- settings.py R-12 锚点位置错误（import 前引用导致启动失败）\r\n- problem_logger.py R-12 锚点位置错误（同 settings.py）\r\n- settings.html 路径搜索修复（三路 fallback）\r\n- 文档中多处过时路径描述（SKILL.md、reference.md）\r\n- `ttask_progress.py` 拼写错误（6 个文件中 30+ 处）\r\n- changelog 过时规则范围 R-01~R-11 → R-01~R-25\r\n- settings.py 注释占位符 `` → ``\r\n- install.py 交互式提示导致测试工具阻塞\r\n- **三端版本号一致**：SKILL.md / _meta.json / changelog 同步为 5.19.0\r\n\r\n---\r\n\r\n## 5.18.0 (2026-06-09)\r\n\r\n### 改进\r\n- **数据目录规范化**：按 skill-standardization R-12 规范重组标准化目录结构\r\n - data/active/、data/completed/ — 进度文件\r\n - output/ — 记录文件（PROBLEMS.md/RISKS.md/LESSONS_REGISTER.md）\r\n - logs/ — 日志；temp/ — 临时文件；backup/、cache/、state/ — 按规范预留\r\n- **6 个脚本路径统一**：problem_logger、problem_daemon、cron_helper、lessons_register、exec_wrapper、task_progress 全部使用 _find_standardization_dir() 计算路径\r\n- **settings.html 移入 assets/**：功能文件与数据目录分离\r\n\r\n### 新增\r\n- **P2 钩子：auto_idle_cutoff** — 空转≥3 次自动 abort\r\n- **P2 钩子：block_skip_review** — update 时检查上一步 REVIEW\r\n\r\n### 修复\r\n- settings.py R-12 锚点位置错误（import 前引用导致启动失败）\r\n- settings.html 路径搜索修复（三路 fallback）\r\n- 文档中多处过时路径描述（SKILL.md、reference.md）\r\n- **HTML UI 保存后同步更新 SKILL.md**（_do_save_config 补调 update_skill_md）\r\n\r\n---\r\n\r\n\r\n\r\n## v5.18.2 (2026-06-09) — 自动版本升级\r\n\r\n### Changed\r\n- 版本号 5.18.1 → 5.18.2（`update --fix` 自动 bump）\r\n## v5.18.1 (2026-06-09) — 自动版本升级\r\n\r\n### Changed\r\n- 版本号 5.18.0 → 5.18.1（`update --fix` 自动 bump）\r\n## 5.17.3 (2026-05-31)\r\n\r\n### 修复\r\n- **R-04**: description 删除版本号\r\n- **R-06**: H1 删除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n## 5.17.2 (2026-05-30)\r\n\r\n### 修复\r\n- **R-04**: description 删除版本号\r\n- **R-06**: H1 删除版本号\r\n- **R-07**: frontmatter 补全 trigger 字段\r\n- **R-10**: changelog 版本号去 v 前缀\r\n- **R-11/R-22**: temp_progress/ 迁移至数据目录\r\n- **R-12**: 3 个脚本补充 DEFAULT_DATA_DIR_RAW 声明\r\n- **R-18/R-19**: SKILL.md 补充 antipatterns/faq 引用\r\n\r\n---\r\n\r\n# triphasic-execution 版本更新日志\r\n## v5.17.0（2026-05-28）\r\n\r\n**改写类型：标准化改造 — 修复 R-11/R-20/R-23 违规**\r\n\r\n### 更新内容\r\n\r\n- ✅ 修复 R-11 产出物路径违规：`assets/` 和 `temp_progress/` 迁至 `skills/.standardization/triphasic-ex"},{"path":"references/examples.md","content":"# examples.md — 完整执行流程示例\r\n\r\n> 本文件包含 triphasic-execution 的完整示例，供参考学习时加载。\r\n\r\n---\r\n\r\n## 示例：多步任务（标准完整流程）\r\n\r\n```\r\n用户：请帮我修复登录接口 Bug\r\n\r\n[triphasic] skill loaded — 执行顺序：语义拆分 → 任务规划 → 执行/审查/推进\r\n\r\n[自检] 当前阶段：收到任务\r\n- F-01 语义拆分：待执行\r\n- F-02 任务规划：待执行\r\n违规项：无，执行语义拆分\r\n\r\n【语义拆分】\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n【原始输入】\r\n请帮我修复登录接口 Bug\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n## 块 1：用户\r\n 角色：requester\r\n 目的：登录接口恢复正常\r\n 诉求：\r\n 1. 修复登录接口中的 Bug\r\n 动机：当前登录功能存在问题\r\n\r\n## 块 2：执行者\r\n 角色：executor\r\n 目的：定位并修复登录接口 Bug\r\n 诉求：\r\n 1. 读取代码定位问题\r\n 2. 修复代码\r\n 3. 验证修复有效\r\n 动机：块1的所有要求\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n[拆分完成，进入任务规划]\r\n\r\n【任务规划】修复登录接口 Bug\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n\r\n📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞\r\n📋 具体要求：添加 Token 验证逻辑，确保未携带有效 Token 的请求被拒绝\r\n⚠️ 潜在风险：更新可能影响正常登录流程\r\n\r\n**执行步骤**：\r\n 步骤 1: 读取登录接口代码\r\n - 任务目的：获取当前代码，理解认证逻辑现状\r\n - 工具/命令：`Read`\r\n - 操作说明：读取 login.py 文件\r\n - 预期结果：获取完整代码内容\r\n - 潜在风险：文件不存在\r\n\r\n 步骤 2: 修复代码\r\n - 任务目的：添加缺失的 Token 验证逻辑\r\n - 工具/命令：`Edit`\r\n - 操作说明：在指定位置添加验证逻辑\r\n - 预期结果：代码更新成功，无语法错误\r\n - 潜在风险：语法错误、引入新 bug\r\n\r\n 步骤 3: 测试验证\r\n - 任务目的：验证修复有效且未影响正常功能\r\n - 工具/命令：`Bash`（pytest）\r\n - 操作说明：运行测试用例\r\n - 预期结果：测试通过\r\n - 潜在风险：测试环境问题\r\n\r\n**进度追踪**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ⏳ │ - │ - │ - │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：0/3（0%）\r\n\r\n**📋 任务后强制记录** [MANDATORY]：\r\n → 问题记录 → 风险记录 → 经验积累\r\n\r\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r\n确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r\n\r\n→ [MANDATORY-F-03] 创建进度文件：\r\npython {SKILL_DIR}/scripts/task_progress.py init \\\r\n --task \"修复登录 Bug\" \\\r\n --purpose \"修复 Token 验证缺失导致的认证绕过漏洞\" \\\r\n --requirements \"添加 Token 验证逻辑\" \\\r\n --risks \"可能影响正常登录\" \\\r\n --steps '[{\"description\":\"读取代码\",\"purpose\":\"理解认证逻辑\",\"tool\":\"Read\"},{\"description\":\"修复代码\",\"purpose\":\"添加验证\",\"tool\":\"Edit\"},{\"description\":\"测试验证\",\"purpose\":\"确认修复有效\",\"tool\":\"Bash\"}]'\r\n\r\n### 🔧 [EXECUTE] - 步骤 1\r\n🔧 执行前重述目的：获取当前代码，理解认证逻辑现状\r\n（读取 login.py...）\r\n\r\n### 🔍 [REVIEW] - 步骤 1\r\n✅成功 -- 发现 Token 验证逻辑缺失\r\n\r\n### 📍 [ADVANCE] - 步骤 1\r\n推进：继续步骤 2\r\n→ 更新进度文件：python {SKILL_DIR}/scripts/task_progress.py update --task \"修复登录 Bug\" --step 1 --status success --review \"发现 Token 验证缺失\" --advance \"继续步骤2\"\r\n\r\n**进度更新**：\r\n ┌──────┬────────┬────────┬────────────┬────────────┐\r\n │ 步骤 │ 状态 │ 重试 │ 审查结论 │ 推进决策 │\r\n ├──────┼────────┼────────┼────────────┼────────────┤\r\n │ 1 │ ✅ │ 0 │ 成功 │ 继续→步骤2 │\r\n │ 2 │ ⏳ │ - │ - │ - │\r\n │ 3 │ ⏳ │ - │ - │ - │\r\n └──────┴────────┴────────┴────────────┴────────────┘\r\n 进度：1/3（33%）▸ 下一：步骤2\r\n\r\n...（继续步骤 2-3）\r\n\r\n【任务完成】\r\n- 目标：修复登录接口 Bug\r\n- 结果：✅成功 -- Token 验证已添加\r\n- 进度：3/3（100%）\r\n→ [MANDATORY-F-09] python {SKILL_DIR}/scripts/ta"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1329,"uniquenessScore":41,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T19:06:13.786Z","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-10T19:06:13.786Z","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-10T21:40:22.684Z","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"}]}}}