[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72YVESGQS2NRBJTTFF248AH":3,"skill-same:01M72YVESGQS2NRBJTTFF248AH":61},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":17,"linkOnly":18,"markdownContent":19,"markdownBody":19,"frontMatter":20,"refName":21,"commitSha":22,"skillDirectory":23,"forksCount":24,"repositoryHtmlUrl":25,"repositoryHomepageUrl":26,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M72YVESGQS2NRBJTTFF248AH","feedback-writer",null,"zxpmail\u002FReqForge","zxpmail","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F45926210?v=4","01M72YNG60707F44824AGAD6HM","01M72YNG6GD4BTF9Q8V35FQMYY",18,"MIT","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"\u003C!-- forge: feedback-writer v1.0 -->\n---\nname: feedback-writer\ndescription: Called by the feedback-observer sub-agent when the user corrects AI behavior, provides improvement feedback, or a Skill execution needs capability assessment recording.\nversion: 1.0.0\nupdated: 2026-05-26\nrequires: []\n---\n\n\u003C!-- begin: task -->\n[Task]\n    Receive context passed in by the main Agent, analyze whether there are feedback signals worth recording.\n    Yes -> Write to ..\u002F..\u002Ffeedback\u002F and update the index.\n    No -> Return \"no new feedback\".\n\n\u003C!-- end: task -->\n\u003C!-- begin: not-for -->\n[Not For]\n    - Evolving rules from feedback patterns -> use \u002Fevolution-engine instead\n    - Fixing the underlying bug that caused the feedback -> use \u002Fbug-fixer instead\n    - General user conversation not related to AI behavior -> do not record, not feedback material\n\n\u003C!-- end: not-for -->\n\u003C!-- begin: dependency-check -->\n[Dependency Check]\n    Automatically executed as the first step when the Skill starts.\n\n    Required:\n    - ..\u002F..\u002Ffeedback\u002F directory → If missing, create from templates\u002Ffeedback-index-template.md\n    - ..\u002F..\u002Ffeedback\u002FFEEDBACK-INDEX.md → If missing, create from templates\u002Ffeedback-index-template.md\n    - Signal context from feedback-observer → correction, failure, or assessment data\n\n\u003C!-- end: dependency-check -->\n\u003C!-- begin: first-principles -->\n[First Principles]\n    **Signal Over Noise**: Only record when a signal is actually observed. Better to miss than to over-record. User frustration at the tool\u002Fenvironment itself is not AI capability feedback.\n    **Dedup Before Write**: Always check FEEDBACK-INDEX.md for existing entries before creating new ones. Merge, don't duplicate. The same failure mode recorded 5 times inflates occurrence counts without adding information.\n    **Scored Feedback**: Every feedback entry must have Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction scores. Score-less feedback can't trigger evolution thresholds. Always fill all 4 score fields.\n    **Context Completeness**: A feedback entry without context (what the AI did, what the correct behavior is, which Skill was in use) is noise — it can't drive evolution.\n\n\u003C!-- end: first-principles -->\n\u003C!-- begin: failure-classification -->\n[Failure Classification]\n    Every feedback entry SHOULD set `failure_class` in frontmatter (enables evolution-engine routing — see evolution-engine [Failure-Class Routing]):\n\n    | Value | When to use | Evolution should target |\n    |-------|-------------|-------------------------|\n    | `skill-defect` | Skill text is missing, wrong, or outdated; Agent followed Skill but guidance failed | `SKILL.md`, `references\u002F`, rule graduation |\n    | `execution-lapse` | Skill already states the correct behavior; Agent skipped steps, ignored HARD-GATE, or hooks did not fire | `forge-bootstrap.md`, hooks, `CLAUDE.md` dispatch — **not** duplicate prose across Skills |\n    | `unset` | Cannot tell yet — add one sentence in body explaining ambiguity | evolution-engine infers; prefer `unset` over guessing |\n\n    **How to decide**:\n    - User says \"the Skill says X but you didn't do X\" → `execution-lapse`\n    - User says \"the Skill never mentioned X\" or \"workflow is wrong\" → `skill-defect`\n    - Same failure after Skill was updated and user confirmed → often `execution-lapse` (bootstrap\u002Fhook)\n\n    **Skill TDD input for evolution**: In the body, include a short **RED** line: \"Without rule Y, Agent did Z\" — feeds evolution-engine RED observation field.\n\n    **Escape field** (`escape` in frontmatter, optional): set it when the defect **escaped past its catching gate** — it surfaced somewhere later than the layer that should have caught it: reported by the user after forge-verify passed, exposed in a later Phase, or found in code-review when forge-verify\u002Fspec-review should have caught it. Record where it surfaced + which gate should have blocked it. An escape-tagged entry is **exempt from the 3-occurrence evolution threshold** — one escape already paid real cost; evolution-engine will propose a permanent check item (see evolution-engine [Escape Routing]).\n\n\u003C!-- end: failure-classification -->\n\u003C!-- begin: observation-dimension-checklist -->\n[Observation Dimension Checklist]\n    The following 5 types of signals trigger feedback recording:\n\n        1. **User Correction**\n           The user corrects the AI's behavior.\n           Signal: \"that's not right\", \"don't do that\", \"you got it wrong\", the user manually edits AI output.\n           -> Tag the corrected Skill and the specific behavior.\n\n        2. **Uncovered Scenario**\n           The Skill encountered a situation its guidance did not cover.\n           Signal: The AI improvises a solution on the spot, skips steps, or is unsure how to proceed.\n           -> Tag which Skill is missing what.\n\n        3. **Repetitive Operation**\n           The user repeatedly performs the same type of operation with no Skill support.\n           Signal: More than 3 consecutive natural-language requests for the same type of thing.\n           -> Tag the operation pattern.\n\n        4. **Quality Issues**\n           The same type of code quality problem keeps showing up.\n           Signal: Multiple consecutive Phases show type errors, naming inconsistencies, CSS side effects, etc.\n           -> Tag the problem type and frequency.\n\n        5. **Skill Capability Assessment**\n           After Skill execution completes, score across 4 dimensions (1-5).\n           Two sources: auto-inferred from failure (see below) or manual after completion.\n\n           **Precision** — Was the Skill guidance accurate?\n           5: Zero corrections \u002F 4: 1-2 minor tweaks \u002F 3: 3+ corrections \u002F 2: Redo direction \u002F 1: User gave up\n\n           **Coverage** — Did the Skill cover what was actually needed?\n           5: Followed guidance completely \u002F 4: 1 case improvised \u002F 3: 2-3 on-the-spot decisions \u002F 2: Heavy improvisation \u002F 1: Severe mismatch\n\n           **Efficiency** — Was the flow smooth?\n           5: Passed first try \u002F 4: 1 clarification \u002F 3: 2-3 rounds of back-and-forth \u002F 2: Many rounds \u002F 1: Deadlocked\n\n           **Satisfaction** — Did the user accept the output?\n           5: Expressed satisfaction unprompted \u002F 4: No negative feedback \u002F 3: Requested changes \u002F 2: Demanded major rework \u002F 1: Rejected output entirely\n\n           **Anti-inflation**: Had corrections -> Precision \u003C= 3 \u002F Improvised -> Coverage \u003C= 3 \u002F 2+ rounds -> Efficiency \u003C= 3 \u002F Had change requests -> Satisfaction \u003C= 3\n\n           **Auto-scoring on failure**: When feedback-observer dispatches with a failure trigger_reason, it provides pre-inferred scores based on the failure type mapping in feedback-observer.md [Auto-Scoring on Failure]. Write these scores directly into the feedback file — do not re-evaluate or inflate them. These scores are the minimum signal the evolution engine needs to function. Without them, feedback accumulates but never triggers proposals.\n\n        **Judgment Standard**:\n        Only record when a signal is actually observed. Better to miss than to over-record.\n\n\u003C!-- end: observation-dimension-checklist -->\n\u003C!-- begin: gotchas -->\n[Gotchas]\n    **Missing context**: Recording \"the user corrected the AI\" without capturing what the AI did, what the correct behavior should be, and which Skill was in use. A feedback entry without context is noise — it can't drive evolution.\n    **Duplicate entries**: The same failure mode recorded 5 times because no one checked FEEDBACK-INDEX.md first. Always check existing entries before creating new ones — merge, don't duplicate.\n    **False positives**: User frustration does not always equal bad AI behavior. Frustration at the tool\u002Fenvironment\u002Flanguage itself should not be recorded as AI capability feedback. Discriminate signal from noise.\n    **Skipping scoring**: Writing qualitative feedback without Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction scores. Score-less feedback can't trigger evolution thresholds. Always fill all 4 score fields.\n\n\u003C!-- end: gotchas -->\n\u003C!-- begin: anti-rationalization-checklist -->\n[Anti-Rationalization Checklist]\n    → `references\u002Fanti-rationalization.md`\n    遇 skipping recording \u002F skipping scoring \u002F false positive 时读取。\n\n\u003C!-- end: anti-rationalization-checklist -->\n\u003C!-- begin: dimension-checklist -->\n[Dimension Checklist]\n    See [references\u002Fdimension-checklist.md](references\u002Fdimension-checklist.md) for the full dimension checklist.\n\n    Must-have criteria:\n    - **Signal Discrimination**: only actual AI behavior issues, not tool frustration\n    - **Scoring Completeness**: all 4 scores filled (Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction)\n    - **Dedup Check**: FEEDBACK-INDEX.md checked before writing\n    - **Context Capture**: what AI did + correct behavior + which Skill\n    - **Scoring**: see dimension-checklist.md for full scoring rubric\n\n\u003C!-- end: dimension-checklist -->\n\u003C!-- begin: quality-rubric -->\n[Quality Rubric]\n    8-item, 16-point scoring system. Ship threshold: **≥ 12** with no critical item scoring 0.\n\n    | # | Dimension | Pts | Critical | Scoring |\n    |---|-----------|-----|----------|---------|\n    | 1 | Signal discrimination | 2 | YES | 2 = Only actual AI behavior issues recorded, tool\u002Fenvironment frustration filtered; 1 = One false positive; 0 = Multiple false positives |\n    | 2 | Dedup accuracy | 2 | YES | 2 = Checked FEEDBACK-INDEX before writing, merged correctly; 1 = Checked but should have merged; 0 = Created duplicate |\n    | 3 | Scoring completeness | 2 | — | 2 = All 4 scores filled (Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction); 1 = 2-3 scores; 0 = \u003C2 scores |\n    | 4 | Context completeness | 2 | — | 2 = What AI did + correct behavior + which Skill + scenario; 1 = Missing one element; 0 = Vague description |\n    | 5 | Failure classification | 2 | — | 2 = failure_class set correctly (skill-defect\u002Fexecution-lapse\u002Funset); 1 = Set but wrong; 0 = Missing |\n    | 6 | Merge correctness | 2 | — | 2 = Merged with matching topic, occurrences updated +1; 1 = Updated but didn't merge; 0 = Separate file for same issue |\n    | 7 | Actionable body | 2 | — | 2 = Body includes RED observation for evolution-engine; 1 = Body describes issue but no RED; 0 = Minimal body |\n    | 8 | Index update | 2 | YES | 2 = FEEDBACK-INDEX.md updated with correct link; 1 = Index updated but wrong format; 0 = Skipped index update |\n\n    **Scoring**: Run `pnpm validate-skill --score core\u002Fskills\u002Ffeedback-writer` to compute.\n\u003C!-- end: quality-rubric -->\n\u003C!-- begin: file-structure -->\n[File Structure]\n    ```\n    feedback-writer\u002F\n    ├── SKILL.md                           # Main Skill definition (this file)\n    └── references\u002F\n        ├── anti-rationalization.md\n        └── dimension-checklist.md\n    ```\n\n\u003C!-- end: file-structure -->\n\u003C!-- begin: output-style -->\n[Output Style]\n    **Tone**: Auditor recording an incident — factual, structured, contextual. Every entry must be actionable by the evolution-engine.\n    **Principles**:\n    - V Every entry includes Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction scores\n    - V Every entry captures what the AI did, what was correct, and which Skill was in use\n    - V Check FEEDBACK-INDEX.md before writing — merge, don't duplicate\n    - X No entries for user frustration with the tool\u002Fenvironment itself\n\n\u003C!-- end: output-style -->\n\u003C!-- begin: output-artifacts -->\n[Output Artifacts]\n    - **..\u002F..\u002Ffeedback\u002F\\\u003Ctopic-name\\>.md** — feedback topic file\n    - **..\u002F..\u002Ffeedback\u002FFEEDBACK-INDEX.md** — feedback index (append or update)\n\n\u003C!-- end: output-artifacts -->\n\u003C!-- begin: routing-rules -->\n[Routing Rules]\n    Project-related -> Write to ..\u002F..\u002Ffeedback\u002F\n    Not project-related -> Do not write, let the AI client handle via default behavior\n    No duplicate writing — each piece of information goes into exactly one system\n\n\u003C!-- end: routing-rules -->\n\u003C!-- begin: workflow -->\n[Workflow]\n    Step 0: Check step traces (if available)\n        If the feedback-observer passed step_traces_path, read the relevant trace\n        records from `.forge\u002Ftrace\u002Fstep-traces.jsonl`. The trace's `attribution.failureClass`\n        and `attribution.reasoning` can serve as starting evidence for the feedback's\n        `failure_class` field. Cross-reference before writing.\n\n    Step 1: Check index\n        Read ..\u002F..\u002Ffeedback\u002FFEEDBACK-INDEX.md (if it does not exist, create from templates\u002Ffeedback-index-template.md)\n    Step 2: Dedup\n        Check if a feedback topic already exists:\n        - Exists -> Update content + occurrences +1 + update updated\n        - Does not exist -> Create new file + update index\n    Step 3: Normalize name\n        Filename in kebab-case, brief topic description\n    Step 4: Write file\n        Write using templates\u002Ffeedback-topic-template.md format (see [File Specification] for template locations)\n    Step 5: Update index\n        Update FEEDBACK-INDEX.md\n\n    For scoring standards during Step 4, reference [Observation Dimension Checklist] section for Precision\u002FCoverage\u002FEfficiency\u002FSatisfaction criteria.\n\n\u003C!-- end: workflow -->\n\u003C!-- begin: file-specification -->\n[File Specification]\n    Storage location: ..\u002F..\u002Ffeedback\u002F\n    Index file: ..\u002F..\u002Ffeedback\u002FFEEDBACK-INDEX.md\n    Index template: ..\u002F..\u002Ffeedback\u002Ftemplates\u002Ffeedback-index-template.md\n    Content template: ..\u002F..\u002Ffeedback\u002Ftemplates\u002Ffeedback-topic-template.md\n    Drift map (optional, ≥3 repeats before evolution): ..\u002F..\u002Ffeedback\u002Ftemplates\u002Fdrift-map-template.md\n\n\u003C!-- end: file-specification -->\n\u003C!-- begin: return-format -->\n[Return Format]\n    Return to the main Agent after execution: - New record: \"Recorded 1 feedback: [title] ([filename])\" - Updated existing: \"Updated [filename], occurrences: N -> N+1\" - No signal: \"No new feedback\"\n\n\u003C!-- end: return-format -->\n\u003C!-- begin: initialization -->\n[Initialization]\n    Step 1: Execute [Dependency Check]\n    Step 2: Execute [Workflow]\n\n\u003C!-- end: initialization -->",{},"main","bf75b50757318dc73f1fee44c5a56f6324242411","adapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer",5,"https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge#readme","https:\u002F\u002Fgithub.com\u002Fzxpmail","2026-10-07 09:22:30",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add zxpmail\u002FReqForge --skill feedback-writer",{"tool":35,"command":36},"bunx","bunx skills add zxpmail\u002FReqForge --skill feedback-writer",{"tool":38,"command":39},"pnpm","pnpm dlx skills add zxpmail\u002FReqForge --skill feedback-writer","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002FSKILL.md",true,[43,49,53,57],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"commands\u002Ffeedback-writer.md","REFERENCE","参考文档",470,"https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002Fcommands\u002Ffeedback-writer.md",{"path":50,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fanti-rationalization.md",1131,"https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002Freferences\u002Fanti-rationalization.md",{"path":54,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fdimension-checklist.md",2409,"https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002Freferences\u002Fdimension-checklist.md",{"path":58,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":59,"sourceHtmlUrl":60},"skill.json",828,"https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fadapters\u002Fopencode\u002F.opencode\u002Fskills\u002Ffeedback-writer\u002Fskill.json",[62,68,75,81,87,93],{"skillNo":63,"name":5,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":17},"01M72YWW227N72XBY2DB439PZ9","Analyze and record user corrections, feedback, and behavior preferences as structured feedback files for the evolution engine.","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Ftest-demo\u002F.claude\u002Fskills\u002Ffeedback-writer\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":17},"01M72YWTKT8GWESEYTJXE6HXG4","evolution-engine","Scan accumulated feedback to identify patterns, generate evolution proposals for SKILL.md, rules, or new Skills.","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Ftest-demo\u002F.claude\u002Fskills\u002Fevolution-engine\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":17},"01M72YWP1C81B4NNENKME8NPMF","db-migration-checker","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Feval-output\u002Fnew-skill-created\u002Fskills\u002Fdb-migration-checker\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":17},"01M72YWN2GJN9XMS4D0BAPDZJR","skill-builder","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Fskill-builder\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":17},"01M72YWK6PBEEV8P1EFYX5TGBD","request-dispatcher","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Frequest-dispatcher\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":17},"01M72YWG2KHA4PRCPSSD9J7166","reqforge-greenkeeper","https:\u002F\u002Fgithub.com\u002Fzxpmail\u002FReqForge\u002Fblob\u002Fmain\u002Fcore\u002Fskills\u002Freqforge-greenkeeper\u002FSKILL.md",[],[]]